360Dialog Integration Guide

Integration Procedure

To integrate 360Dialog in the test environment follow these steps:

  1. Save +4930609859535 on your phone as a 360Dialog WhatsApp contact.
  2. Message START to this number, 360Dialog will return your API key. Or use this link to send this message via WhatsApp web. For example
  3. Edit CCM environment variables file and change the following variables: 
    1. 360DIALOG_HOST_URL=https://waba-sandbox.360dialog.io
    2. 360DIALOG_API_KEY=<API-Key you received from 360Dialog>
    3. 360DIALOG_WHATSAPP_NUMBER= +4930609859535
  1. Perform up operation for CCM container.
  2. Open terminal in any Linux machine where internet is available and curl is installed and change YOUR-API-KEY with th API Key you received from 360Dialog and YOUR-HOST-FQDN with public FQDN of the host where CCM is deployed. Perform curl request after updating these two parameters. 
  3. curl --request POST \
         --url https://waba-sandbox.360dialog.io/v1/configs/webhook \
         --header 'Content-Type: application/json' \
         --header 'D360-Api-Key: YOUR-API-KEY' \
         --data '{"url": "https://YOUR-HOST-FQDN/ccm/360notifications"}'
  4. The sandbox setup is complete. You can send messages via WhatsApp and they will be delivered to CCM via 360Dialog. 


To integrate 360Dialog in the production environment follow these steps:

  1. Save the number being used in your production environment in your phone as a 360Dialog WhatsApp contact.
  2. Edit CCM environment variables file and change the following variables: 
    1. 360DIALOG_HOST_URL=https://waba.360dialog.io
    2. 360DIALOG_API_KEY=<API-Key you generated at 360dialog WhatsApp account>
    3. 360DIALOG_WHATSAPP_NUMBER=<production environment number>
  3. Perform up operation for CCM container.
  4. Open terminal in any Linux machine where internet is available and curl is installed and change YOUR-API-KEY with the API Key you received from 360Dialog and YOUR-HOST-FQDN with public FQDN of the host where CCM is deployed. Perform curl request after updating these two parameters. 
  5. curl --request POST \
         --url https://waba.360dialog.io/v1/configs/webhook \
         --header 'Content-Type: application/json' \
         --header 'D360-Api-Key: YOUR-API-KEY' \
         --data '{"url": "https://YOUR-HOST-FQDN/ccm/360notifications"}' 
  6. The setup is complete. You can send messages via WhatsApp and they will be delivered to CCM via 360Dialog. 


if the curl command is not being run from the terminal, then run it through postman or some other tool.


Environment Variables for 360Dialog WhatsApp Integration

Following CCM environment variables must be configured for Twilio integration. See Customer Channel Manager (CCM) Environment Variables for a complete list of all environment variables.

Environment VariableDefault ValueDescription
360DIALOG_HOST_URLhttps://waba.360dialog.ioBase URL for 360Dialog API / sandbox. Do not use a forward slash (/) at the end of this URL
360DIALOG_API_KEYhFxSCeu7JxpxHccdQg0lhfuiAK360Dialog API key
360DIALOG_WHATSAPP_NUMBER+41762884806Connector Number, same as TWILIO_WHATSAPP_FROM_NUMBER in case of Twilio
360DIALOG_READ_TIMEOUT3000360Dialog API read timeout in milliseconds
360DIALOG_CONNECT_TIMEOUT3000360Dialog API connect timeout in milliseconds



The WhatsApp integration via Twilio and 360Dialog are independent of each other and can be used simultaneously. However, WHATSAPP_ROUTING_POLICY is a shared variable that implies to WhatsApp channel rather than WhatsApp vendors.