Coster
Open in CMSThis tutorial walks you through connecting your qlar agent to a WhatsApp Business number using Coster as your BSP (Business Solution Provider).
Before you start
- Your agent answers well in Preview and has been published at least once. See Preview and Publish Changes.
- You have read Connect to WhatsApp, which explains the Published and Draft configurations used below.
From Coster, make sure you have:
- An active Coster account with a registered WhatsApp Business number.
- The following values ready from your Coster dashboard:
- Account ID
- Division ID
- Access Token
- Template Access Token
Tip: Contact your Coster account manager or log in to the Coster portal to retrieve these credentials. The Access Token is used for sending messages, while the Template Access Token is specifically for sending WhatsApp message templates.
Step 1 β Open Channel Settings
- Open the CMS dashboard and select the agent you want to connect.
- In the left sidebar, open Channels β WhatsApp.
- Choose which configuration to set up: Published Configuration (for live users) or Draft Configuration (for testing). Click the corresponding tab.
Note: You can configure both tabs independently. Start with Draft to test first, then repeat the steps for Published when ready to go live.
Step 2 β Start the Setup Wizard
If no WhatsApp number has been connected yet, a setup wizard appears.
- In the Protocol dropdown, select Coster.
- In the Phone Number field, enter your WhatsApp Business phone number in international format, for example
+6281234567890. - Click Save (or the confirmation button in the wizard).
The wizard closes and the full configuration form loads.
Step 3 β Enter Account and Division Details
In the configuration form:
- Account ID β Enter the Account ID from your Coster dashboard.
- Division ID β Enter the Division ID assigned to your WhatsApp channel in Coster.
Step 4 β Enter Access Tokens
- Access Token β Enter the access token used to authenticate API calls to the Coster messaging service.
- Template Access Token β Enter the separate token used for sending WhatsApp message templates.
Note: Coster uses two separate tokens β one for general messaging and one specifically for template messages. Make sure you enter both correctly. Templates are used for proactive notifications and automated messages that start a conversation outside the 24-hour window.
Step 5 β Configure Webhook
qlar needs Coster to forward incoming messages to qlar's servers.
- In the qlar form, locate the Webhook Secret field. Click Regenerate to create a secret, then copy it.
- Below the secret field, qlar displays your Webhook URL in a code block. Copy that URL as well.
- Go to your Coster dashboard and navigate to the webhook or callback URL settings for your WhatsApp channel.
- Paste the Webhook URL and Webhook Secret (as the verify token or signature key, depending on Coster's interface).
- Save the webhook configuration in Coster.
Warning: Keep the Webhook Secret confidential. If it is compromised, regenerate it in qlar and update the value in your Coster dashboard immediately.
Step 6 β Save and Publish
Click the Save button at the bottom of the form.
Saving marks your agent as having unpublished changes, so the Publish button appears at the top of the CMS. Click Publish so the connection is synced to the live version of your agent.
Check the result
To verify the connection is working:
- Send a test message to your WhatsApp Business number from a personal WhatsApp account.
- The message should appear in your agent's conversation history in the CMS dashboard.
- Your agent should respond automatically based on its configuration.
Tip: If messages are not arriving, confirm the Webhook URL is correctly set in your Coster dashboard and that the Access Token has not expired.
Next steps
- Next in the journey: Connect to Instagram, to answer Instagram direct messages too.
- Repeat these steps for the Draft Configuration tab using a separate Coster test number if you want a safe environment for testing changes.
- Using a different provider for another number? See Meta Cloud or Qontak.
- Session Management: see Connect to WhatsApp to tune when a conversation session ends.