Conversation Agent

Events that occur when a Chat/Conversation Agent Session starts, ends or is analysed

conversation_agent_session.started

{
   "data":{
      "agent_version":{
         "agent_id":"ce52b7c6-dc4e-46cc-8c00-0f5d7ae657de",
         "created_by_id":8,
         "description":"Staffing agent for Express Employment",
         "id":"0304743f-6cbf-49c3-823b-d1d14bf36601",
         "llm_id":"191548c3-30cc-4cf7-85de-78d7387188c0",
         "name":"Staffing Agent",
         "organization_id":"4e2afdc4-1ebe-4882-b4c2-29b9f17f27e1",
         "provider_settings":{
            "allow_user_dtmf":true,
            "ambient_sound":null,
            "ambient_sound_volume":1,
            "backchannel_frequency":0.8,
            "backchannel_words":null,
            "begin_message_delay_ms":0,
            "boosted_keywords":null,
            "denoising_mode":"noise-cancellation",
            "enable_backchannel":false,
            "end_call_after_silence_ms":600000,
            "fallback_voice_ids":null,
            "interruption_sensitivity":1,
            "language":"multi",
            "max_call_duration_ms":3600000,
            "max_chat_duration_ms":86400000,
            "normalize_for_speech":false,
            "post_call_analysis_data":[
               {
                  "choices":[
                     "Phone call",
                     "SMS",
                     "Email"
                  ],
                  "description":"",
                  "name":"Preferred_contact_method",
                  "type":"enum"
               },
               {
                  "description":"",
                  "examples":[
                     
                  ],
                  "name":"How_did_the_candidate_hear_about_XYZ_Employment",
                  "type":"string"
               },
               {
                  "description":"Is the person currently working",
                  "name":"Currently_working",
                  "type":"boolean"
               },
               {
                  "description":"",
                  "name":"How_comfortable_using_a_computer",
                  "type":"number"
               }
            ],
            "post_call_analysis_model":"gpt-4o-mini",
            "pronunciation_dictionary":null,
            "reminder_max_count":1,
            "reminder_trigger_ms":10000,
            "responsiveness":1,
            "stt_mode":"fast",
            "user_dtmf_options":null,
            "vocab_specialization":"general",
            "voice_id":"11labs-Adrian",
            "voice_model":null,
            "voice_speed":1,
            "voice_temperature":1,
            "voicemail_option":{
               "action":{
                  "type":"hangup"
               }
            },
            "volume":1
         }
      },
      "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
      "id":"03d8d3f6-d983-41ae-85d6-ac1cf135a223",
      "started_at":"2025-08-19T06:40:45Z",
      "ended_at":null,
      "ended_reason":null,
      "chat_completion_rating":null,
      "chat_summary":null,
      "user_sentiment":null,
      "custom_analysis_data":null,
      "messages":[
         {
            "attachments":[
               
            ],
            "body":"job",
            "campaign_contact_id":null,
            "campaign_id":null,
            "channel_id":"e9338384-7dfb-4626-984f-2e28b08bf67e",
            "contact_id":"1d1f0a02-28f6-41cb-bd99-78a17e68bdb6",
            "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
            "created_at":"2025-08-26T11:03:29.168397Z",
            "delivery_status":"webhook_delivered",
            "direction":"INBOUND",
            "from":"+13237452021",
            "id":"dc3ec41f-4a72-46cf-8fe6-9ae4600536fd",
            "language":null,
            "metadata":{
               
            },
            "mode":"manual",
            "sequence_id":null,
            "step_contact_id":null,
            "step_id":null,
            "to":"+12136991845",
            "translated_body":null,
            "translation_language":null,
            "type":"sms",
            "updated_at":"2025-08-26T11:03:29.702804Z",
            "user_id":null
         },
         {
            "attachments":[
               
            ],
            "body":"Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
            "campaign_contact_id":null,
            "campaign_id":null,
            "channel_id":"e9338384-7dfb-4626-984f-2e28b08bf67e",
            "contact_id":"1d1f0a02-28f6-41cb-bd99-78a17e68bdb6",
            "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
            "created_at":"2025-08-26T11:03:33.187688Z",
            "delivery_status":"failed",
            "direction":"OUTBOUND",
            "from":"+12136991845",
            "id":"5785d2fa-4a8d-4e14-ad45-2aaa69738977",
            "language":null,
            "metadata":{
               
            },
            "mode":"ai",
            "sequence_id":null,
            "step_contact_id":null,
            "step_id":null,
            "to":"+13237452021",
            "translated_body":null,
            "translation_language":null,
            "type":"sms",
            "updated_at":"2025-08-26T11:03:33.261283Z",
            "user_id":null
         }
      ],
      "chat_transcript":"User: job\nAgent: Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
      "translated_chat_transcript":"User: job\nAgent: Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
      "language":"en",
      "translation_language":"en"
   },
   "api_version":"v1",
   "event":"conversation_agent_session.started",
   "created_at":"2025-08-19T06:40:57.416929Z",
   "request_id":"09b5e5e5-7302-48a0-8c05-7f250787aad6"
}

conversation_agent_session.ended

{
   "data":{
      "agent_version":{
         "agent_id":"ce52b7c6-dc4e-46cc-8c00-0f5d7ae657de",
         "created_by_id":8,
         "description":"Staffing agent for Express Employment",
         "id":"0304743f-6cbf-49c3-823b-d1d14bf36601",
         "llm_id":"191548c3-30cc-4cf7-85de-78d7387188c0",
         "name":"Staffing Agent",
         "organization_id":"4e2afdc4-1ebe-4882-b4c2-29b9f17f27e1",
         "provider_settings":{
            "allow_user_dtmf":true,
            "ambient_sound":null,
            "ambient_sound_volume":1,
            "backchannel_frequency":0.8,
            "backchannel_words":null,
            "begin_message_delay_ms":0,
            "boosted_keywords":null,
            "denoising_mode":"noise-cancellation",
            "enable_backchannel":false,
            "end_call_after_silence_ms":600000,
            "fallback_voice_ids":null,
            "interruption_sensitivity":1,
            "language":"multi",
            "max_call_duration_ms":3600000,
            "max_chat_duration_ms":86400000,
            "normalize_for_speech":false,
            "post_call_analysis_data":[
               {
                  "choices":[
                     "Phone call",
                     "SMS",
                     "Email"
                  ],
                  "description":"",
                  "name":"Preferred_contact_method",
                  "type":"enum"
               },
               {
                  "description":"",
                  "examples":[
                     
                  ],
                  "name":"How_did_the_candidate_hear_about_Express_Employment",
                  "type":"string"
               },
               {
                  "description":"Is the person currently working",
                  "name":"Currently_working",
                  "type":"boolean"
               },
               {
                  "description":"",
                  "name":"How_comfortable_using_a_computer",
                  "type":"number"
               }
            ],
            "post_call_analysis_model":"gpt-4o-mini",
            "pronunciation_dictionary":null,
            "reminder_max_count":1,
            "reminder_trigger_ms":10000,
            "responsiveness":1,
            "stt_mode":"fast",
            "user_dtmf_options":null,
            "vocab_specialization":"general",
            "voice_id":"11labs-Adrian",
            "voice_model":null,
            "voice_speed":1,
            "voice_temperature":1,
            "voicemail_option":{
               "action":{
                  "type":"hangup"
               }
            },
            "volume":1
         }
      },
      "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
      "id":"03d8d3f6-d983-41ae-85d6-ac1cf135a223",
      "started_at":"2025-08-19T06:40:45Z",
      "ended_at":"2025-08-22T08:13:53Z",
      "ended_reason":"user_ended",
      "chat_completion_rating":null,
      "chat_summary":null,
      "user_sentiment":null,
      "custom_analysis_data":null,
      "messages":[
         {
            "attachments":[
               
            ],
            "body":"job",
            "campaign_contact_id":null,
            "campaign_id":null,
            "channel_id":"e9338384-7dfb-4626-984f-2e28b08bf67e",
            "contact_id":"1d1f0a02-28f6-41cb-bd99-78a17e68bdb6",
            "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
            "created_at":"2025-08-26T11:03:29.168397Z",
            "delivery_status":"webhook_delivered",
            "direction":"INBOUND",
            "from":"+13237452021",
            "id":"dc3ec41f-4a72-46cf-8fe6-9ae4600536fd",
            "language":null,
            "metadata":{
               
            },
            "mode":"manual",
            "sequence_id":null,
            "step_contact_id":null,
            "step_id":null,
            "to":"+12136991845",
            "translated_body":null,
            "translation_language":null,
            "type":"sms",
            "updated_at":"2025-08-26T11:03:29.702804Z",
            "user_id":null
         },
         {
            "attachments":[
               
            ],
            "body":"Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
            "campaign_contact_id":null,
            "campaign_id":null,
            "channel_id":"e9338384-7dfb-4626-984f-2e28b08bf67e",
            "contact_id":"1d1f0a02-28f6-41cb-bd99-78a17e68bdb6",
            "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
            "created_at":"2025-08-26T11:03:33.187688Z",
            "delivery_status":"failed",
            "direction":"OUTBOUND",
            "from":"+12136991845",
            "id":"5785d2fa-4a8d-4e14-ad45-2aaa69738977",
            "language":null,
            "metadata":{
               
            },
            "mode":"ai",
            "sequence_id":null,
            "step_contact_id":null,
            "step_id":null,
            "to":"+13237452021",
            "translated_body":null,
            "translation_language":null,
            "type":"sms",
            "updated_at":"2025-08-26T11:03:33.261283Z",
            "user_id":null
         }
      ],
      "chat_transcript":"User: job\nAgent: Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
      "translated_chat_transcript":"User: job\nAgent: Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
      "language":"en",
      "translation_language":"en"
   },
   "api_version":"v1",
   "event":"conversation_agent_session.ended",
   "created_at":"2025-08-19T06:40:57.416929Z",
   "request_id":"77b9508f-e209-4dff-b0e8-1d4d3f57dccf"
}

conversation_agent_session.analyzed

{
   "data":{
      "agent_version":{
         "agent_id":"ce52b7c6-dc4e-46cc-8c00-0f5d7ae657de",
         "created_by_id":8,
         "description":"Staffing agent for Express Employment",
         "id":"0304743f-6cbf-49c3-823b-d1d14bf36601",
         "llm_id":"191548c3-30cc-4cf7-85de-78d7387188c0",
         "name":"Staffing Agent",
         "organization_id":"4e2afdc4-1ebe-4882-b4c2-29b9f17f27e1",
         "provider_settings":{
            "allow_user_dtmf":true,
            "ambient_sound":null,
            "ambient_sound_volume":1,
            "backchannel_frequency":0.8,
            "backchannel_words":null,
            "begin_message_delay_ms":0,
            "boosted_keywords":null,
            "denoising_mode":"noise-cancellation",
            "enable_backchannel":false,
            "end_call_after_silence_ms":600000,
            "fallback_voice_ids":null,
            "interruption_sensitivity":1,
            "language":"multi",
            "max_call_duration_ms":3600000,
            "max_chat_duration_ms":86400000,
            "normalize_for_speech":false,
            "post_call_analysis_data":[
               {
                  "choices":[
                     "Phone call",
                     "SMS",
                     "Email"
                  ],
                  "description":"",
                  "name":"Preferred_contact_method",
                  "type":"enum"
               },
               {
                  "description":"",
                  "examples":[
                     
                  ],
                  "name":"How_did_the_candidate_hear_about_XYZ_Employment",
                  "type":"string"
               },
               {
                  "description":"Is the person currently working",
                  "name":"Currently_working",
                  "type":"boolean"
               },
               {
                  "description":"",
                  "name":"How_comfortable_using_a_computer",
                  "type":"number"
               }
            ],
            "post_call_analysis_model":"gpt-4o-mini",
            "pronunciation_dictionary":null,
            "reminder_max_count":1,
            "reminder_trigger_ms":10000,
            "responsiveness":1,
            "stt_mode":"fast",
            "user_dtmf_options":null,
            "vocab_specialization":"general",
            "voice_id":"11labs-Adrian",
            "voice_model":null,
            "voice_speed":1,
            "voice_temperature":1,
            "voicemail_option":{
               "action":{
                  "type":"hangup"
               }
            },
            "volume":1
         }
      },
      "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
      "id":"03d8d3f6-d983-41ae-85d6-ac1cf135a223",
      "started_at":"2025-08-19T06:40:45Z",
      "ended_at":"2025-08-22T08:13:53Z",
      "ended_reason":"user_ended",
      "chat_completion_rating":"incomplete",
      "chat_summary":"The user inquired about job opportunities via SMS.",
      "user_sentiment":"neutral",
      "custom_analysis_data":{
         "Currently_working":false,
         "How_comfortable_using_a_computer":0,
         "How_did_the_candidate_hear_about_Express_Employment":"",
         "Preferred_contact_method":"SMS"
      },
      "messages":[
         {
            "attachments":[
               
            ],
            "body":"job",
            "campaign_contact_id":null,
            "campaign_id":null,
            "channel_id":"e9338384-7dfb-4626-984f-2e28b08bf67e",
            "contact_id":"1d1f0a02-28f6-41cb-bd99-78a17e68bdb6",
            "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
            "created_at":"2025-08-26T11:03:29.168397Z",
            "delivery_status":"webhook_delivered",
            "direction":"INBOUND",
            "from":"+13237452021",
            "id":"dc3ec41f-4a72-46cf-8fe6-9ae4600536fd",
            "language":null,
            "metadata":{
               
            },
            "mode":"manual",
            "sequence_id":null,
            "step_contact_id":null,
            "step_id":null,
            "to":"+12136991845",
            "translated_body":null,
            "translation_language":null,
            "type":"sms",
            "updated_at":"2025-08-26T11:03:29.702804Z",
            "user_id":null
         },
         {
            "attachments":[
               
            ],
            "body":"Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
            "campaign_contact_id":null,
            "campaign_id":null,
            "channel_id":"e9338384-7dfb-4626-984f-2e28b08bf67e",
            "contact_id":"1d1f0a02-28f6-41cb-bd99-78a17e68bdb6",
            "conversation_id":"1ce466d7-4aea-4e05-ada4-82f20d19e219",
            "created_at":"2025-08-26T11:03:33.187688Z",
            "delivery_status":"failed",
            "direction":"OUTBOUND",
            "from":"+12136991845",
            "id":"5785d2fa-4a8d-4e14-ad45-2aaa69738977",
            "language":null,
            "metadata":{
               
            },
            "mode":"ai",
            "sequence_id":null,
            "step_contact_id":null,
            "step_id":null,
            "to":"+13237452021",
            "translated_body":null,
            "translation_language":null,
            "type":"sms",
            "updated_at":"2025-08-26T11:03:33.261283Z",
            "user_id":null
         }
      ],
      "chat_transcript":"User: job\nAgent: Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
      "translated_chat_transcript":"User: job\nAgent: Got it! Are you currently looking for job opportunities? If so, I can help you with that.",
      "language":"en",
      "translation_language":"en"
   },
   "api_version":"v1",
   "event":"conversation_agent_session.analyzed",
   "created_at":"2025-08-19T06:40:57.416929Z",
   "request_id":"1c3aae2b-06c4-4652-8a13-61d067826eae"
}