Configure the Click To Call Widget

To deploy a Click To Call widget, you need to create a Voice Gateway Endpoint and set up the Click To Call widget in the Endpoint settings. The default setup includes only voice communication and live transcription. For a more advanced setup, read the Tutorials section.

Prerequisites

Configure a speech provider in the Voice Preview Settings section of the Project settings.
Access to Voice Gateway.
Configure a Flow.
For testing purposes, allow microphone access in your browser and, if needed, in your device settings.

Restrictions

Click To Call currently doesn’t support DTMF input by default.
Click To Call supports only the Dial transfer type for call transfers.

When you generate the embedding code for the Click To Call widget in the Voice Gateway Endpoint settings, Cognigy.AI automatically creates an Application in the Voice Gateway Self-Service Portal. You can change the voice settings in the Application or Flow editor.

Configure the Widget

To embed a Click To Call widget into your website, follow these steps:

In Deploy > Endpoints, click + New Endpoint and select Voice Gateway.
In the New Endpoint section, configure the following:
- Name — enter a unique name.
- Flow — select a Flow you previously created.
Click the Set Up Click To Call Integration button inside the Click To Call Embedding HTML field. The embedding code for the Click To Call widget is generated in a code editor. This step generates an Application in the Voice Gateway Self-Service Portal. The Application receives a name with the following pattern Widget - <Cognigy.AI Project Name> - <Voice Gateway Endpoint Name>.
In the Click To Call Widget Settings section, configure the following:

Enable Click To Call Widget — activate the toggle.
AI Agent Name — enter the name displayed on the Click To Call widget, for example, Package Support.
Tagline — enter the text displayed under the AI Agent name on the widget, for example, Get help with your package.
AI Agent Avatar Logo URL — URL of the image to be displayed on the widget, for example, https://www.<domain>.com/logo.png. If empty, the Cognigy.AI logo is used.
(Optional) Theme — select the color theme of the widget, for example, Clean white (default), Dark mode, or AI Purple.
Display Live Transcription — toggle to show conversation transcript in the widget.

(Optional) Configure a Privacy Notice

In Click To Call Widget Config in the Voice Gateway Endpoint settings, you can add a privacy notice with the following parameters:

Parameter	Description
Enable Privacy Notice	Displays a privacy notice at the beginning of each chat session to inform users about data handling practices and prompts the users to accept or decline the privacy policy. Accepting the privacy policy is required to start the conversation, ensuring compliance and user trust. If the user declines the privacy policy, the conversation doesn’t start.
Privacy Notice Title	This parameter is displayed only if you toggle on Enable Privacy Notice. Sets the heading that appears at the top of the privacy notice screen. By default, it is set to `Privacy Notice`.
Privacy Notice Text	This parameter is displayed only if you toggle on Enable Privacy Notice. Sets the message that users see in the privacy notice prompt. This parameter supports Markdown syntax. The default text is `Please accept our privacy policy to start your chat`. You can customize this message to provide more detailed information about your data collection, usage practices, and users’ rights, ensuring clarity and building trust from the outset of the chat interaction.
Submit Button	This parameter is displayed only if you toggle on Enable Privacy Notice. Sets the text displayed on the button users click to accept the Privacy Notice. By default, the button is labeled `Submit`.
Cancel Button Text	This parameter is displayed only if you toggle on Enable Privacy Notice. Sets the text displayed on the button users click to decline the Privacy Notice. By default, the button is labeled `Cancel`.
Privacy Policy Link Title	This parameter is displayed only if you toggle on Enable Privacy Notice. Sets the text that will be displayed as the title for the Privacy Policy link. The link title allows you to tailor the label of the link to better match the tone and context of your brand.
Privacy Policy Link URL	This parameter is displayed only if you toggle on Enable Privacy Notice. Sets the URL that directs users to your privacy policy.

After configuring the Click To Call widget in the Endpoint settings, you can test it by clicking the Open Demo Widget button in the upper-right corner of the Endpoint settings.

Voice Configuration

When you generate the Click To Call embedding code, an application is created in the Voice Gateway Self-Service Portal. The speech provider label is automatically generated from a lowercase version of the name of the speech provider connection you configured, with spaces replaced by underscores. For example, if you named the connection Click To Call EU, the label is click_to_call_eu. The generated Application inherits all speech providers configured in the Voice Preview Settings section in the Project settings in Cognigy.AI. By default, the Application uses the speech provider configured in the Project settings for STT and TTS. For TTS, the Application uses the speech provider’s default voice. You can change the voice and speech provider of your AI Agent, for example, in the AI Agent Node or Set Session Config Node, without switching the default speech provider. If you set up a new speech provider in Cognigy.AI after the Click To Call application is created, make sure the new provider is configured in the widget Application in the Voice Gateway Self-Service Portal.

Transfer Calls

You can transfer the call with Click To Call by adding a Transfer Node to your Flow. Click To Call supports only Dial transfer calls to SIP targets. For call transfers, Click To Call uses any carrier configured in your Voice Gateway account. If you have only one carrier, Click To Call uses the configured carrier as the default outbound carrier. If you have multiple carriers, make sure you configure the carrier for outbound calls from the Default carrier for Click To Call calls list on your Account page in the Voice Gateway Self-Service Portal.

Next Steps

Embed the Click To Call Widget in your website

More Information

Tutorials

Overview

Tutorials

Click To Call SDK

Prerequisites

Restrictions

Configure a Click To Call Widget

Voice Configuration

Transfer Calls

Next Steps

More Information

​Prerequisites

​Restrictions

​Configure a Click To Call Widget

​Voice Configuration

​Transfer Calls

​Next Steps

​More Information

Prerequisites

Restrictions

Configure a Click To Call Widget

Voice Configuration

Transfer Calls

Next Steps

More Information