--- title: "Configure a webhook" slug: "vcc-configure-a-webhook" updated: 2026-07-23T10:06:34Z published: 2026-07-23T10:06:34Z canonical: "help.8x8.com/vcc-configure-a-webhook" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.8x8.com/llms.txt > Use this file to discover all available pages before exploring further. # Configure a webhook In a fast-paced working environment such as a Contact Center, where businesses rely on both AI technology and people to handle customer interactions, webhooks are essential for exchanging real-time data between integrated systems or services. A webhook bridges the gap between the different web systems to ensure that when a user interacts with a chatbot, it can instantly send or request data from external servers or APIs. This configuration can be used to connect 8x8 digital channels to an external chatbot or route interactions to 8x8 agents from a chatbot where the vendor is using it's own widget. ### Use case Let's say AcmeJets Inc. a growing e-commerce business, is experiencing an increase in customer support queries. A high percentage of the queries are regarding the status of the orders. To prevent increasing the wait-time which impacts customer satisfaction, AcmeJets is looking to implement the 8x8 Intelligent Customer Assistant (ICA), a powerful, user-friendly conversational AI solution that enables businesses to create simple to complex automated self-service experiences across digital channels. As an admin, you must configure the ICA chatbot using the chat widget, create a webhook in Configuration Manager, create and assign channels, to help automate routine inquiries and allow agents to focus on more complex issues. **To create a webhook in Configuration Manager:** 1. Log in to your 8x8 Configuration Manager account. 2. From the menu, click **Integration**. 3. Click the **Webhook** tab. 4. Click **Add webhook** from the top of the table. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/cfgmngr-integration-webhooks.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A12%3A41Z&se=2026-11-03T22%3A12%3A41Z&sr=c&sp=r&sig=TNjTzJgRzWe1UoxjtU3kasGS8t8RztmbtVgbamTiAEY%3D) 5. In the **Name** field, add the webhook’s name. 6. In the **URL** filed, add the endpoint URL. 7. In the **Chat API Version** field, select **Chat Gateway v1.0**. 8. Click **Test Connection** to see if your connection is working. A notification banner displays to inform you if the connection test was successful or failed. 9. Click **Save**. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/cfgmngr-integration-add-webhooks.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A12%3A41Z&se=2026-11-03T22%3A12%3A41Z&sr=c&sp=r&sig=TNjTzJgRzWe1UoxjtU3kasGS8t8RztmbtVgbamTiAEY%3D) 10. Locate your webhook from the Webhooks List and click the **Edit** ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/icon-edit_15x18.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A12%3A41Z&se=2026-11-03T22%3A12%3A41Z&sr=c&sp=r&sig=TNjTzJgRzWe1UoxjtU3kasGS8t8RztmbtVgbamTiAEY%3D) icon. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/cfgmngr-edit-webhook.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A12%3A41Z&se=2026-11-03T22%3A12%3A41Z&sr=c&sp=r&sig=TNjTzJgRzWe1UoxjtU3kasGS8t8RztmbtVgbamTiAEY%3D) 11. From the **Manage channels assignment for current webhook** table, select the [chatbot channel](/support/docs/configuring-a-chatbot-using-the-8x8-chat-widget) you created. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/cfgmngr-webhooks-manage-channels.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A12%3A41Z&se=2026-11-03T22%3A12%3A41Z&sr=c&sp=r&sig=TNjTzJgRzWe1UoxjtU3kasGS8t8RztmbtVgbamTiAEY%3D) 12. Click **Save**. Webhooks are used during the configuration of the chatbot. The chatbot configuration varies depending on whether the customer is using their own channels or the 8x8 digital channels. For more information about connecting the chat gateway to a 3rd party channel, refer to this [8x8 Developer docs article](https://developer.8x8.com/actions-events/docs/chat-workflow). **Configure a chatbot using the 8x8 chat widget** Let's say AcmeJets Inc. wants to implement ICA, a powerful, user-friendly conversational AI solution, to provide automated self-service experiences to their customers. AcmeJets wants ICA to handle customer queries regarding the progress of their orders. If a customer query requires personalized help, the [ICA must be configured to hand over the conversation to a live agent](/support/docs/configuring-the-agent-handover-from-cognigy-to-8x8). The agent would receive the full chat transcript of the conversation the customer had with the chatbot to prevent customer frustration by having to repeat the issue to the agent. To learn how to configure the chatbot using the 8x8 chat widget, refer to this [8x8 Support article](/support/docs/configuring-a-chatbot-using-the-8x8-chat-widget). **Configure a chatbot using the Cognigy chat widget** Let's say a customer wants to streamline customer support processes by implementing an AI chatbot to handle digital channel interactions from customers inquiring about the progress of their orders. Through the chat widget, the chatbot would help promptly assist customer queries and improve customer satisfaction. However, if a webchat requires personalized assistance, the chatbot must be able to connect to the chat gateway to route the customer through to a queue and then to a live agent. The agent would receive the full chat transcript of the conversation the customer had with the chatbot to prevent customer frustration by having to repeat the issue to the agent. To learn how to configure the ICA using the Cognigy chat widget, refer to this [8x8 Support article](/support/docs/configuring-an-ica-chatbot-using-the-cognigy-chat-widget).