Some products and features are in the process of being renamed. Generative playbook and flow features are also being migrated to a single consolidated console. See the details.
Stay organized with collections
Save and categorize content based on your preferences.
Call companion provides an interactive visual interface
that end-users can access on their mobile phone
during a voice call with your agent.
This visual interface is meant to supplement the call,
not replace it.
With this interface,
a user can provide text input,
be shown images,
and view the call transcript in real time.
The user can choose to interact with your agent
via the voice call or call companion;
either can be used at any point during the call.
This feature includes a built-in SMS gateway.
To initiate the mobile interface,
Dialogflow sends an SMS message to the user's phone.
This message is sent once during a conversation.
The user is prompted to click a link in the message,
which takes them to a Dialogflow hosted web page.
Sample use cases:
Input complex information such as name,
address, email address, pin numbers, credit card numbers, bank account
numbers, and so on.
Troubleshooting where sharing an indicative image can help the
customer with following the remediation steps.
Showing clickable menu options.
Limitations
The following limitations apply:
Call companion's built-in SMS functionality currently only works with
Dialogflow CX Phone Gateway.
Dialogflow CX Phone Gateway limitations apply.
To use call companion with a different telephony
system or to use a custom setup for SMS gateway, please reach
out to your Google account team.
There is only a single phone number provisioned
for the built-in SMS feature. This will be shared across all Dialogflow
users for this feature, but you can add your company name to the SMS. To reserve your own phone number, please reach out to your Google account team.
The built-in SMS phone number can send SMS only to the US phone numbers.
Call companion only supports text input, clickable chips and
image output as interactive and rich content.
The number of concurrent calls using call companion cannot exceed 1000
for a single project.
Call companion does not work with VPC-SC by default. To enable it, contact
support.
Go to Agent Settings > Multimodal and enable Conversation History.
Select the Manage tab.
Click Integrations in the left sidebar menu.
Enable call companion:
For a new telephony integration:
Follow the steps to enable
Dialogflow CX Phone Gateway,
and check the Enable call companion option
for a new
conversation profile.
For an existing telephony integration:
On the Manage tab, click Integrations,
then click Manage for CX Phone Gateway.
Click the phone number you want to enable call companion for.
Check the Enable call companion option
in the conversation profile settings.
Configure call companion:
To add your company name to the built-in SMS,
go to the agent settings,
enter your company name on the Multimodal tab,
and click Save.
To trigger call companion at the beginning of a call,
check Automatically trigger call companion at the start of the conversation
on the Multimodal tab.
Alternatively,
you can enable the Send Call Companion SMS option
under Call companion settings in the Default Welcome Intent route
in the Default Start Flow.
Checking or unchecking the former automatically enables or disables the latter.
To trigger call companion at a later conversation turn,
enable the Send Call Companion SMS option under
Call companion settings for any fulfillment within your agent.
If enabled in multiple fulfillments,
the SMS is sent for whichever fulfillment is triggered first.
To add an introductory message to let the
user know about call companion and the SMS sent, add a response
fulfillment
for the same fulfillment or page where you have enabled the call companion SMS.
If you are using the automatic trigger option, you add this introductory
message to the Default welcome intent route on the Default Start Page. This
introductory message can be something like "Hi there. To interact with the
call visually, click on the link I have sent you via SMS".
Test call companion by calling the Dialogflow CX Phone Gateway
number for which you have enabled call companion.
Rich content
You can add custom payloads that are specific to call companion in
fulfillments where you want to
display rich elements in the call companion web page.
To do this:
Click Add dialogue option.
Select Custom payload.
Click Select template. You will see a list of predefined templates for
call companion rich elements.
Select the required template and update it as per your use case. Note that
only the fields present in the predefined templates are supported.
Agent design recommendations
The following recommendations apply to call companion:
For turns requiring interactive end-user input
(text input, chip tapping, and so on), adjust the
no speech timeout
on the page, flow, or agent level to allow
the user enough time to input the required content.
You may want to create special pages with page-level timeouts
where the end-user may need more time to interact with call companion.
If you want to provide different agent responses for voice and call
companion text (for example, the virtual agent may speak a short introductory
sentence, but you want the corresponding call companion text to show a more
verbose text), you can set the voice response as
output audio text
and the call companion response as the Text response.
When you are using the Dialogflow CX Phone Gateway,
it will only use the output audio text for voice output
and will only use the text response for the call companion transcript.
The link sent to the end-user's phone
includes your Cloud project ID.
Make sure that this ID does not contain any sensitive
information that you do not want to be made public.
Call companion respects the
parameter redaction
settings.
While the call companion web page is open,
an end-user can see these parameter values in the call transcript
as they are provided.
If the page is initially loaded or reloaded after parameters are provided,
the values are shown as redacted.
Settings
You can customize the following fields for the Dialogflow CX Messenger UI or
call companion UI:
Company name or title
Font
Logo (must be stored in a Google Cloud bucket, format: gs://<bucket name>/<object name>)
Text color (select the color or enter hex code)
Background color (select the color or enter hex code)
User input background color (select the color or enter hex code)
Agent response background color (select the color or enter hex code)
Customize the UI
Select an agent with call companion enabled and click Agent Settings,
then the Multimodal tab.
On the Multimodal page, select the UI settings tab. Options for UI
settings should be visible. Make your selections, then click Save to
save your changes.
If you are using Dialogflow CX Messenger, go to the left-hand navigation
menu and click Manage > Integrations > Dialogflow CX Messenger > Manage.
The code that appears includes your new UI changes. Copy this code to add
the agent to your website.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eCall companion offers a visual interface on the user's mobile phone during a voice call, allowing for text input, image display, and real-time call transcript viewing.\u003c/p\u003e\n"],["\u003cp\u003eThis feature uses a built-in SMS gateway to send a link to the user's phone, enabling them to access the interactive interface, with a required opt-in consent for sending SMS messages.\u003c/p\u003e\n"],["\u003cp\u003eThe built-in SMS functionality of call companion currently only works with Dialogflow CX Phone Gateway and is limited to sending messages to US phone numbers, using a shared number across users.\u003c/p\u003e\n"],["\u003cp\u003eCall companion's interface can be customized with different settings, including company name, font, logo, text, and background colors, and it can also display rich content.\u003c/p\u003e\n"],["\u003cp\u003eCall companion has specific limitations, such as a 1000 concurrent call limit per project, and it only supports text input, clickable chips, and image output, while also not working with VPC-SC by default.\u003c/p\u003e\n"]]],[],null,["# Call companion provides an interactive visual interface\nthat end-users can access on their mobile phone\nduring a voice call with your agent.\nThis visual interface is meant to supplement the call,\nnot replace it.\nWith this interface,\na user can provide text input,\nbe shown images,\nand view the call transcript in real time.\nThe user can choose to interact with your agent\nvia the voice call or call companion;\neither can be used at any point during the call.\n\nThis feature includes a built-in SMS gateway.\nTo initiate the mobile interface,\nDialogflow sends an SMS message to the user's phone.\nThis message is sent once during a conversation.\nThe user is prompted to click a link in the message,\nwhich takes them to a Dialogflow hosted web page.\n| **Note:** You are required to obtain consent to send SMS messages to end-users. This can be achieved by incorporating a consent related question in the agent design before sending the SMS. Here's an example of appropriate opt-in consent verbiage: \"Do you consent to receiving an SMS containing a link to your call transcript? Respond YES or press 1.\"\n\nSample use cases:\n\n- Input complex information such as name, address, email address, pin numbers, credit card numbers, bank account numbers, and so on.\n- Troubleshooting where sharing an indicative image can help the customer with following the remediation steps.\n- Showing clickable menu options.\n\nLimitations\n-----------\n\nThe following limitations apply:\n\n- Call companion's built-in SMS functionality currently only works with [Dialogflow CX Phone Gateway](/dialogflow/cx/docs/concept/integration/phone-gateway). Dialogflow CX Phone Gateway limitations apply. To use call companion with a different telephony system or to use a custom setup for SMS gateway, please reach out to your Google account team.\n- There is only a single phone number provisioned for the built-in SMS feature. This will be shared across all Dialogflow users for this feature, but you can add your company name to the SMS. To reserve your own phone number, please reach out to your Google account team.\n- The built-in SMS phone number can send SMS only to the US phone numbers.\n- Call companion only supports text input, clickable chips and image output as interactive and [rich content](#rich-content).\n- The number of concurrent calls using call companion cannot exceed 1000 for a single project.\n- Call companion does not work with VPC-SC by default. To enable it, contact support.\n\nUse call companion\n------------------\n\nTo use call companion:\n\n1. Go to the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent.\n4. Go to **Agent Settings** \\\u003e **Multimodal** and enable **Conversation History**.\n5. Select the **Manage** tab.\n6. Click **Integrations** in the left sidebar menu.\n7. Enable call companion:\n - For a new telephony integration: Follow the steps to enable [Dialogflow CX Phone Gateway](/dialogflow/cx/docs/concept/integration/phone-gateway), and check the **Enable call companion** option for a new conversation profile.\n - For an existing telephony integration: On the **Manage** tab, click **Integrations** , then click **Manage** for CX Phone Gateway. Click the phone number you want to enable call companion for. Check the **Enable call companion** option in the conversation profile settings.\n8. Configure call companion:\n 1. To add your company name to the built-in SMS, go to the agent settings, enter your company name on the **Multimodal** tab, and click **Save**.\n 2. To trigger call companion at the beginning of a call, check **Automatically trigger call companion at the start of the conversation** on the **Multimodal** tab. Alternatively, you can enable the **Send Call Companion SMS** option under **Call companion settings** in the Default Welcome Intent route in the Default Start Flow. Checking or unchecking the former automatically enables or disables the latter.\n 3. To trigger call companion at a later conversation turn, enable the **Send Call Companion SMS** option under **Call companion settings** for any fulfillment within your agent. If enabled in multiple fulfillments, the SMS is sent for whichever fulfillment is triggered first.\n 4. To add an introductory message to let the user know about call companion and the SMS sent, add a response [fulfillment](https://cloud.google.com/dialogflow/cx/docs/concept/fulfillment) for the same fulfillment or page where you have enabled the call companion SMS. If you are using the automatic trigger option, you add this introductory message to the Default welcome intent route on the Default Start Page. This introductory message can be something like \"Hi there. To interact with the call visually, click on the link I have sent you via SMS\".\n 5. (Optional) Add [rich content](#rich-content).\n9. Test call companion by calling the Dialogflow CX Phone Gateway number for which you have enabled call companion.\n\nRich content\n------------\n\nYou can add custom payloads that are specific to call companion in\n[fulfillments](/dialogflow/cx/docs/concept/fulfillment) where you want to\ndisplay rich elements in the call companion web page.\n\nTo do this:\n\n1. Click **Add dialogue option**.\n2. Select **Custom payload**.\n3. Click **Select template**. You will see a list of predefined templates for call companion rich elements.\n4. Select the required template and update it as per your use case. Note that only the fields present in the predefined templates are supported.\n\nAgent design recommendations\n----------------------------\n\nThe following recommendations apply to call companion:\n\n- For turns requiring interactive end-user input (text input, chip tapping, and so on), adjust the [no speech timeout](/dialogflow/cx/docs/concept/agent-settings#settings-speech) on the page, flow, or agent level to allow the user enough time to input the required content. You may want to create special pages with page-level timeouts where the end-user may need more time to interact with call companion.\n- If you want to provide different agent responses for voice and call companion text (for example, the virtual agent may speak a short introductory sentence, but you want the corresponding call companion text to show a more verbose text), you can set the voice response as [output audio text](/dialogflow/cx/docs/concept/fulfillment#tts) and the call companion response as the **Text** response. When you are using the Dialogflow CX Phone Gateway, it will only use the output audio text for voice output and will only use the text response for the call companion transcript.\n- The link sent to the end-user's phone includes your Cloud project ID. Make sure that this ID does not contain any sensitive information that you do not want to be made public.\n\nCall companion logs\n-------------------\n\nYou can view call companion logs in\n[Cloud logging](/dialogflow/cx/docs/concept/logging)\nand\n[Conversation history](/dialogflow/cx/docs/concept/conversation-history).\n\nParameter redaction\n-------------------\n\nCall companion respects the\n[parameter redaction](/dialogflow/cx/docs/concept/parameter#redact)\nsettings.\nWhile the call companion web page is open,\nan end-user can see these parameter values in the call transcript\nas they are provided.\nIf the page is initially loaded or reloaded after parameters are provided,\nthe values are shown as redacted.\n\nSettings\n--------\n\nYou can customize the following fields for the Dialogflow CX Messenger UI or\ncall companion UI:\n\n- Company name or title\n- Font\n- Logo (must be stored in a Google Cloud bucket, format: `gs://\u003cbucket name\u003e/\u003cobject name\u003e`)\n- Text color (select the color or enter hex code)\n- Background color (select the color or enter hex code)\n- User input background color (select the color or enter hex code)\n- Agent response background color (select the color or enter hex code)\n\n### Customize the UI\n\n1. Select an agent with call companion enabled and click **Agent Settings** ,\n then the **Multimodal** tab.\n\n2. On the Multimodal page, select the **UI settings** tab. Options for UI\n settings should be visible. Make your selections, then click **Save** to\n save your changes.\n\n3. If you are using **Dialogflow CX Messenger** , go to the left-hand navigation\n menu and click **Manage \\\u003e Integrations \\\u003e Dialogflow CX Messenger \\\u003e Manage**.\n The code that appears includes your new UI changes. Copy this code to add\n the agent to your website."]]