Skip to main content
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

​
Restrictions

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

​
Configure a Click To Call Widget

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.
To embed a Click To Call widget into your website, follow these steps:
  1. In Deploy > Endpoints, click + New Endpoint and select Voice Gateway.
  2. In the New Endpoint section, configure the following:
    • Name — enter a unique name.
    • Flow — select a Flow you previously created.
  3. 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>.
  4. 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.
In Click To Call Widget Config in the Voice Gateway Endpoint settings, you can add a privacy notice with the following parameters:
ParameterDescription
Enable Privacy NoticeDisplays 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 TitleThis 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 TextThis 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 ButtonThis 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 TextThis 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 TitleThis 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 URLThis 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

By default, the Application created when you generate the Click To Call embedding code uses the default voice of the speech provider set in the Voice Preview Settings section in the Project settings in Cognigy.AI. You can change the voice and speech provider of your AI Agent, for example, in the AI Agent Node or Set Session Config Node. If you set up a new speech provider in Cognigy.AI, make sure they are 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

​
More Information