Outbound Notifications API

The Outbound Notifications API, a Talkdesk Digital Engagement™ solution, allows you to send notification messages at scale through multiple channels using different message types. You can proactively reach your customers by sending WhatsApp messages to multiple recipients in a single batch request.

Use Case

Send bulk notifications such as:

• Order confirmations
• Appointment reminders
• Promotional messages

Messages are sent from a WhatsApp sender you control and can:

• Target multiple recipients
• Use free-form content (within a 24-hour window)
• Use pre-approved WhatsApp templates

Access & Authentication

• Supported Regions and Base URLs
• Access and Registration
• Authentication

Supported Channels

• WHATSAPP

The current request schema supports the WHATSAPP channel and allows either:

• direct content messages
• template-based messages

For contacts without a reply in the last 24 hours, only WhatsApp template messages are permitted. See this process to register templates.

The sender identifier needs to be configured as a WhatsApp touchpoint in the Channels App, following this process.

This operation is asynchronous. A successful call returns 202 Accepted with provider message identifiers and an initial delivery status.

Endpoint

POST https://api.talkdeskapp.com/outbound/notifications

Request Body

Content-Type: application/json

Top-level Schema

messages[]

Each message must include exactly one of:

• content
• template

destinations[]

Direct Content Messages

Due to Meta restrictions, this only applies to contact numbers that have sent messages to the touchpoint sender within the last 24 hours.

When using content, the payload shape follows the WhatsApp content model.

Example

{
  "content": {
    "body": {
      "type": "TEXT",
      "text": "Hello, how can I help you?"
    }
  }
}

Supported Direct Body Variants

Template Messages

Templates must be approved by Meta.

The sending success rate depends on the quality of the sender and the template.

Template Fields

Available Language Codes

Here’s the available language code for the template:

🌐 Template Example

{
  "template": {
    "name": "welcome_message",
    "language": "en",
    "variables": {
      "1": "Talkdesk",
      "2": "Support Team"
    }
  }
}

Request Options

The optional options object applies settings to the whole request:

options.bind_conversation

Example Request

{
  "channel": "WHATSAPP",
  "sender": "+123456789",
  "messages": [
    {
      "destinations": [
        {
          "to": "+987654321",
          "message_id": "client-msg-1"
        },
        {
          "to": "+5551234567"
        }
      ],
      "template": {
        "name": "welcome_message",
        "language": "en",
        "variables": {
          "1": "Talkdesk",
          "2": "Support Team"
        }
      }
    }
  ],
  "options": {
    "bulk_id": "bulk-123",
    "group_id": "campaign-42",
    "group_name": "Spring promo",
    "group_info": {
      "source": "crm",
      "segment": "vip"
    },
    "bind_conversation": {
      "enabled": true
    }
  }
}

Success Response

Status: 202 Accepted

Response Schema

messages[]

Example Response

{
  "bulk_id": "0f0d3c86-2355-4409-9968-ac871cdf88d0",
  "messages": [
    {
      "message_id": "infobip-msg-id-123",
      "destination": "+987654321",
      "status": "PENDING"
    }
  ]
}

Error Responses

Notes

• The request is batch-oriented: One call can submit up to 500 messages.
• The response confirms acceptance, not final delivery.
• A destination can include a client-side message_id for correlation.
• Grouping and binding are controlled via options.