Setting up the IVA for Client Channel API
Use the Client Channel API to securely communicate between your Pega Platform application, your integration layer, and third-party client channels, for example, Teams, Webex, or Slack. As a result, you make Pega Intelligent Virtual Assistant (IVA) for Digital Messaging more accessible by engaging with your customers in their preferred social messaging channels.
The Client Channel API provides you with a Digital Messaging Service endpoint to which you can send payload requests in JSON format. The payload requests indicate an action during a chat conversation, for example, when a customer in the client channel sends a message. Similarly, you can set up an endpoint for your integration layer to receive payload requests from the Digital Messaging Service, for example, when the chatbot or CSR sends a reply or is busy typing.
You access Digital Messaging Manager in the Digital Messaging channel to configure individual messaging accounts in one
place for your application. For relevant training materials, see the Configuring Digital Messaging Manager module
on Pega Academy.
- 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
following fields:
- 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.
- 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:
Client Channel API settings 
Previous topic Setting up the IVA for iOS app messaging Next topic Client Channel API