Send a WhatsApp message

In order to send a WhatsApp message in Bird CRM you will need to setup a few things.

Step 1: Setup your API key

To send WhatsApp messages, you must create an Access key with the Application Developer role. Refer to the Access Management section to learn more. To send a message, set it up as shown below.

The ability to create Access keys can be found in Settings -> Security -> Access Keys.

Optional: Setup your number

This step is optional if your number is already configured in your Meta account. To send messages using a WhatsApp channel, you must first acquire a long-code number and complete all compliance requirements to activate it. You can buy your number in Developer Cloud by selecting Numbers -> LongCode Numbers -> Buy a number.

Step 2: Setup your channel

To set up your WhatsApp channel, ensure you have access to the Meta account you want to associate with it. Once you confirm the correct access and permissions, simply fill in the required information displayed in Developer Cloud after navigating to WhatsApp -> WhatsApp Setup. For more details, please refer to Install WhatsApp.

If the setup is successful, you should see a similar screen. Ensure that the channel is marked as Live and healthy.

Step 3: Setup a template

In Developer Cloud, select the Template Management option and create a new WhatsApp template by following the provided instructions, for more details, please refer to WhatsApp Message Templates. Keep in mind that using a template is a requirement from Meta to initiate a conversation.

Ensure that your template is both active and approved.

Step 4: Send a message

With the Access key, Channel and Template set up, you’re ready to send messages. Use the following example cURL request to send a WhatsApp message using your API key, workspace ID, template ID, channel ID:

curl -X POST "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/channels/123e4567-e89b-12d3-a456-426614174000/messages" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd" \
-d '{
  "receiver": {
    "contacts": [
      {
        "identifierValue": "+17077066620"
      }
    ]
  },
  "template": {
    "projectId": "123e4567-e89b-12d3-a456-426614174000",
    "version": "123e4567-e89b-12d3-a456-426614174000",
    "locale": "en",
    "variables": {
        "otp": "142144"
    }
  }
}'

{
    "id": "f67bc25c-3d20-4c4f-aee1-eb3a29e1f2fd",
    "channelId": "123e4567-e89b-12d3-a456-426614174000",
    "sender": {
        "connector": {
            "id": "9cd58079-2b09-4ee2-894d-12ca17a2e05d",
            "identifierValue": "118900147813532"
        }
    },
    "receiver": {
        "contacts": [
            {
                "id": "55f3777a-4e2d-4a54-ba11-47ec80aa7e6e",
                "identifierKey": "phonenumber",
                "identifierValue": "+17077066620",
                "platformAddress": "+17077066620",
                "countryCode": "US"
            }
        ]
    },
    "body": {
        "type": "authentication",
        "authentication": {
            "otp": {
                "disclaimer": false,
                "expirationTime": 60,
                "actions": [
                    {
                        "type": "postback",
                        "postback": {
                            "text": "Copy code",
                            "payload": "",
                            "otpType": "COPY_CODE"
                        }
                    }
                ]
            }
        }
    },
    "meta": {
        "extraInformation": {
            "use_wa_platform_account_id_approach": "true"
        }
    },
    "template": {
        "projectId": "65453a57-6e41-45d0-87ef-da85bfb4edd3",
        "version": "756cc66a-3a51-441a-b98d-cc3a5400b9df",
        "name": "",
        "locale": "en",
        "variables": {
            "otp": "142144"
        },
        "shortLinks": {
            "enabled": true,
            "domain": "test-4.ew1.sandbox.brd.to"
        },
        "parameters": []
    },
    "reference": "",
    "parts": [],
    "status": "accepted",
    "reason": "",
    "direction": "outgoing",
    "context": {},
    "lastStatusAt": "2024-12-03T13:00:00.000Z",
    "createdAt": "2024-12-03T13:00:00.000Z",
    "updatedAt": "2024-12-03T13:00:00.000Z",
    "notification": {},
    "batchId": null
}

Step 5: Checking messages

You can verify the message status through the following mechanisms:

1. UI

In the developer console, you can easily access the Message Log under the WhatsApp section.

Alternatively, you can navigate to Manage Channels, select WhatsApp, and then choose the channel you used. After that, switch to the Logs tab to view the message logs.

2. API

To retrieve message details via the API, refer to the Messaging API Documentation. You can find more information on the available endpoints, request formats, and required parameters.

3. Webhook

Subscribe to the channels service and the whatsapp.outbound event in Developer Cloud to receive updates. For additional information, refer to the Notifications API. Example configuration: