Overview

The WhatsApp Direct Send Message API simplifies WhatsApp utility messaging by enabling you to send business-initiated messages without creating and managing message templates manually.

Benefits:

Direct Send allows you to send Utility and Authentication messages even without having a pre-approved template. Direct Send streamlines the integration process, reduces template management complexity, and provides greater flexibility when template recategorization policies are enforced. This allows you to accelerate deployment of utility messaging use cases while leveraging WhatsApp as a scalable communication channel.

How Direct Send Works

Direct Send automatically creates templates and matches message content against existing templates before sending. Template creation and message match is executed on Meta side once the request is received at Meta from Kaleyra Platform.

Flow Diagram:

Message Processing Flow

When a message is submitted:

• Meta first checks whether the message content matches an existing template already approved and stored by Meta.
• If a matching template is found, the message is sent using that template.
• If no matching template exists, Meta falls back to predefined onboarding templates to continue message delivery.
• Meta then asynchronously creates a new template based on the submitted message content for future use.

Auto Template Creation

During auto template creation:

• The message language is detected automatically.
• A new template is generated and stored for subsequent matching requests.

Supported Message Types

The WhatsApp Direct Send Message API supports following message categories:

• Utility messages
• Authentication messages

The WhatsApp Direct Send Message API enables you to send messages of these categories without requiring pre-approved templates.

The WhatsApp Direct Send Message API support following message types:

1. Text Message - Send simple text-based messages containing a message body and URLs.

2. Interactive button messages for Call-to-Action URL or Reply buttons (recommended) - Send interactive messages containing Call-to-Action (CTA) buttons or Reply buttons.

When sending messages with Interactive Button, following Buttons type are supported:

a. Reply Buttons

The Interactive Reply Button messages allow you to send predefined response options that end users can select directly within WhatsApp.

• Supports up to 3 Reply buttons per message.

• When an end user selects a button, a webhook notification is triggered containing the selected response.

  b. Mixed Buttons (Interactive button messages for Call-to-Action URL or Reply buttons)

You can combine Call-to-Action (CTA) URL buttons and Reply buttons with the same message.

• Supports up to 10 buttons in total (minimum one of each kind).
• Supports a maximum of two CTA URL buttons.
• CTA buttons are always displayed before Reply buttons.

3. Direct Send API with Document Header - Send utility messages with a document as the message header, allowing you to share documents such as invoices, receipts, statements, or reports along with the message.

   📘

   Notes:

   • The message header must be of type document.
   • The request payload must include "category": "utility".
   • Document headers can be used with supported Interactive Button messages.

4. Direct Send API with Video Header - Send utility messages with a video as the message header, allowing you to share videos along with relevant message content.

   📘

   Notes:

   • The message header must be of type video.
   • The request payload must include "category": "utility".
   • Video headers can be used with supported Interactive Button messages.

This page contains the following topic:

Direct Send Message