Enable Cloud Pub/Sub notifications for CCAI Agent Assist events
Stay organized with collections
Save and categorize content based on your preferences.
Enabling Cloud Pub/Sub notifications lets you receive a
notification each time an Agent Assist event completes. You can
configure Agent Assist to send a notification for all events or only
specified events, including Agent Assist suggestions, conversation
lifecycle information, and live transcripts.
You can configure Agent Assist to send a notification for
all events or for specified events in your conversation profile.
A conversation profile configures a
set of parameters that control the suggestions or notifications made to an agent
during a conversation. You have the option of configuring Cloud Pub/Sub
notifications either using the
Agent Assist console
or by calling the API directly. You can configure each type of notification
separately, using the topics that you've created.
Enable Cloud Pub/Sub notifications using the Agent Assist console
When you create a new conversation profile using the
Agent Assist console,
you can select which notification types you'd like to receive using the topics
you've created:
Enable Cloud Pub/Sub notifications using the API
If you prefer to call the API directly to create or update a conversation profile,
check this section for the locations you should configure in the
ConversationProfile
resource.
The following example is configured to enable all Cloud Pub/Sub notifications
that match a designated TOPIC_ID.
[[["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-28 UTC."],[[["\u003cp\u003eAgent Assist can send notifications via Cloud Pub/Sub for completed events, including suggestions, conversation lifecycle updates, and live transcripts.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure Agent Assist to send notifications for all events or only for specific event types, like suggestion_event, life_cycle_event, or new_message_event, through conversation profiles.\u003c/p\u003e\n"],["\u003cp\u003eTo enable Cloud Pub/Sub notifications, you need to have the Dialogflow API enabled and have already created a Cloud Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eNotifications can be configured via the Agent Assist console or by directly calling the API, allowing for separate configuration of each notification type.\u003c/p\u003e\n"],["\u003cp\u003eEach notification type—suggestion, lifecycle, and new message—sends different data formats in its Cloud Pub/Sub message, with examples provided for each.\u003c/p\u003e\n"]]],[],null,["# Enable Cloud Pub/Sub notifications for CCAI Agent Assist events\n\nEnabling [Cloud Pub/Sub](/pubsub) notifications lets you receive a\nnotification each time an Agent Assist event completes. You can\nconfigure Agent Assist to send a notification for all events or only\nspecified events, including Agent Assist suggestions, conversation\nlifecycle information, and live transcripts.\n\nPrerequisites\n-------------\n\n1. Enable the [Dialogflow API](/dialogflow/es/docs/reference/rest/v2-overview).\n2. Follow the instructions to [create a Cloud Pub/Sub topic](/pubsub/docs/create-topic-console).\n\nEnable Cloud Pub/Sub notifications\n----------------------------------\n\nYou can configure Agent Assist to send a notification for\n*all events* or for *specified events* in your **conversation profile**.\n\nA [conversation profile](/agent-assist/docs/conversation-profile) configures a\nset of parameters that control the suggestions or notifications made to an agent\nduring a conversation. You have the option of configuring [Cloud Pub/Sub](/pubsub)\nnotifications either using the\n[Agent Assist console](https://agentassist.cloud.google.com)\nor by calling the API directly. You can configure each type of notification\nseparately, using the topics that you've created.\n\nFor more details about Cloud Pub/Sub configuration parameters, see the\n[`conversationProfile` reference documentation](/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles).\n\n### Enable Cloud Pub/Sub notifications using the Agent Assist console\n\n| **Note:** You can use the Agent Assist simulator to create a conversation. In this case, notifications for live transcripts and suggestions are published to Google internal Pub/Sub topics instead of the ones you configured in your conversation profiles.\n\nWhen you create a new conversation profile using the\n[Agent Assist console](https://agentassist.cloud.google.com),\nyou can select which notification types you'd like to receive using the topics\nyou've created:\n\n### Enable Cloud Pub/Sub notifications using the API\n\nIf you prefer to call the API directly to create or update a conversation profile,\ncheck this section for the locations you should configure in the\n[`ConversationProfile`](/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles)\nresource.\n\nThe following example is configured to enable all Cloud Pub/Sub notifications\nthat match a designated `TOPIC_ID`. \n\n```json\n{\n \"name\": \"projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID\",\n \"displayName\": \"CONVERSATION_PROFILE_NAME\",\n \"automatedAgentConfig\": {\n },\n \"humanAgentAssistantConfig\": {\n \"notificationConfig\": {\n \"topic\": \"projects/PROJECT_ID/topics/FEATURE_SUGGESTION_TOPIC_ID\",\n \"messageFormat\": \"JSON\"\n },\n \"humanAgentSuggestionConfig\": {\n \"featureConfigs\": [{\n \"enableEventBasedSuggestion\": true,\n \"suggestionFeature\": {\n \"type\": \"ARTICLE_SUGGESTION\"\n },\n \"conversationModelConfig\": {\n }\n }]\n },\n \"messageAnalysisConfig\": {\n }\n },\n \"notificationConfig\": {\n \"topic\": \"projects/PROJECT_ID/topics/CONVERSARION_LIFECYCLE_TOPIC_ID\",\n \"messageFormat\": \"JSON\"\n },\n \"newMessageEventNotificationConfig\": {\n \"topic\": \"projects/PROJECT_ID/topics/LIVE_TRANSCRIPT_TOPIC_ID\",\n \"messageFormat\": \"JSON\"\n },\n \"newRecognitionResultNotificationConfig\": {\n \"topic\": \"projects/PROJECT_ID/topics/NEW_RECOGNITION_RESULT_TOPIC_ID\",\n \"messageFormat\": \"JSON\"\n },\n \"languageCode\": \"en-US\"\n}\n```\n\n### Configuration of the Cloud Pub/Sub message\n\n### Content of the Cloud Pub/Sub message\n\nThe content of the [Cloud Pub/Sub message](/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage) depends on the event that triggers that Cloud Pub/Sub notification."]]
