Agentless WhatsApp notifications


  • Genesys Cloud CX 1 Digital Add-on II, Genesys Cloud CX 2, Genesys Cloud CX 3, Genesys Cloud CX 2 Digital, or Genesys Cloud CX 3 Digital license
  • An active WhatsApp Messaging integration
  • OAuth client credentials
  • Conversation > Message > Create permission assigned to a role
  • WhatsApp account and preapproved message template. For more information, see Get an approved WhatsApp message template and Add a WhatsApp template message.
  • Obtain opt-in permission from your customers. You must comply with WhatsApp’s policies. For more information, see the Get Opt-in for WhatsApp page on the Facebook for Developers website.
  • Uses API to create conversations that include the ACD message fee. For more information, see Messaging pricing.

    Agentless WhatsApp notifications feature allows you to send WhatsApp notifications without involving an agent. This feature allows Genesys Cloud to send WhatsApp notifications from backend systems automatically, based on triggered events. You can also send WhatsApp notifications from an Architect flow or Agent Scripting using a data action.

    For example, use Agentless WhatsApp notifications to offer voice callers the option to connect using WhatsApp. After your IVR asks the caller for permission to contact them via WhatsApp and confirms their WhatsApp number, send a notification to them with the Call Data Action feature. For more information about configuring these actions, see About the Genesys Cloud data actions integration. Or, use the Agentless WhatsApp notifications API to start or continue conversations with your customers or internal team members. Make sure to observe WhatsApp’s opt-in policy when contacting customers proactively.

      Access agentless WhatsApp notifications using a public API. For more information, see the Conversation API and Agentless messages page in the Developer Center.

      Note: Contact your Genesys account advisor before you use this feature.

      Trigger events

      To configure agentless WhatsApp notifications based on triggered events from backend systems:

      1. Create or use an existing OAuth client. For more information, see Create an OAuth client.
      2. Use your OAuth client’s credentials to generate a token. For more information, see Grant – Client Credentials.
      3. Use your new token to call the new Agentless API endpoint. For more information, see Agentless SMS API and Agentless SMS Tutorial in the Developer Center.

      Architect flow

      To configure agentless WhatsApp notifications from an Architect flow:

      1. Create a data action that calls the WhatsApp notification API. For more information, see About the Genesys Cloud data actions integration.
      2. Use that data action within the flow. For more information, see Use data actions in Architect for integrations.
      • Do not format destination numbers in E.164 format.
      • Make sure to provision source numbers within the organization.
      • Send messages to only numbers for which you collect and store the appropriate opt-in for WhatsApp.
        • Do not attempt to automatically send WhatsApp messages to every caller from your Architect flow. Ask permission first using a conditional branch in your IVR.
        • Send notifications only to customers that are active on WhatsApp. If you send too many messages to numbers not active on WhatsApp, you may be blocked. Best practice is to send notifications to customers who have opted in or have messaged previously on the WhatsApp channel.
      • ACD messaging pricing applies to conversations created by the Agentless WhatsApp API. For more information, see Messaging pricing.
      • The Agentless WhatsApp API can send messages to a customer regardless of an existing connected WhatsApp conversation. A connected WhatsApp conversation is an active conversation between an agent and a customer. The API can create a new conversation with the customer, and also add a new message to an existing conversation in the disconnected state.