- Learn about the Client Channel API, including its best practices and the supported payload format. For more information, see Client Channel API, Client Channel API guidelines, and Client Channel API payload requirements.
- Configure Digital Messaging channel security settings. For more information, see Configuring Digital Messaging channel security.
- If you do not have an IVA for Digital Messaging, create a Digital Messaging channel. For more information, see Creating a Digital Messaging channel.
- In the navigation pane of App Studio, click Channels.
- In the Current channel interfaces section, click the icon that represents your existing Digital Messaging channel.
- In the Digital Messaging channel, click the Connection tab.
- Click Manage connections.
- In the Digital Messaging Manager window, click Add Connection, and then click the Client Channel API icon.
- In the New Client Channel API section, complete the
- In the Name field, enter a unique name for your channel.
- In the Client webhook field, enter the URL that
you previously configured in your integration layer for your client
channel. For more information, see Client Channel API.
Note: You must configure the webhook URL so that the URL is publicly accessible (off VPN) to enable communication with Digital Messaging Service. If your integration layer is behind a firewall or otherwise limits access to internal-only users and components, you must set up the webhook URL so that the URL is reachable publicly. Ensure that the URL string starts with "https".
- Click Save.
Result: Digital Messaging Service creates a new channel connection and displays the following fields:
- Connection ID (JWT issuer)
- A unique ID assigned to your connection. Use this ID to generate a JSON Web Token (JWT) that is required for transmitting messages.
- Client Webhook
- The URL that you specify when creating the connection. This URL is the publicly accessible target endpoint for your client channel to receive messages from Digital Messaging Service and your chatbot and CSR.
- Digital Messaging Webhook
- The endpoint URL on Digital Messaging Service. The service uses this URL to receive messages from your client channel sent through your integration layer.
- JWT Secret
- The service uses the JWT Secret value to authenticate the communication between your integration layer and Digital Messaging Service. Use the JWT Secret value to generate the JWT that is required for transmitting messages.
The following figure shows the sample values generated for a configured Client Channel API connection:
Your customers can send and receive messages from the chatbot or an agent in the same way that they send and receive messages using other connection types for the Digital Messaging channel.