# Webhooks Navigate to Administration | Webhooks | Add Webhooks have the ability to send an HTTP POST request to a URL. The HTTP POST body includes CDR data and can be used to trigger an action or populate an external database. ### Webhook Subscription Properties | Webhook Endpoint | HTTP POST URL | | -------------------------- | -------------------------------------------------------------------------------- | | Is Active | Enables or Disables the Webhook | | Webhook Events | Types of webhook events to send. See [Webhook Event Types](#webhook-event-types) | | Additional Webhook Headers | Custom Headers to send in the HTTP POST (Optional) | ### Webhook Event Types #### App.TestWebhook This webhook type is used for testing purposes only. The webhook is triggered by selecting the Send Test Webhook button. #### App.QueueWebhook This webhook type sends CDR data that is generated from contact center queues. The webhook is triggered after a queue call has been ended. | Property | Description | | ----------------------- | --------------------------------------------------------------------------------------------------------- | | CallId | Internal Call ID | | ScenarioId | Microsoft Teams Call ID | | CallDirection | Direction of Call (Inbound/Outbound) | | CallerName | Name of Caller | | CallerAdId | Entra ID object ID of caller | | CallerUpn | User principal name of caller | | CallerNumber | Phone number of caller | | StartDateTime | Start date/time of call | | EndDateTime | End date/time of call | | CallLength | Total call length (wait time plus talk time) | | WaitTime | Amount of time the caller has waited in the queue before connecting with the agent | | TalkTime | Amount of time the agent and caller were connected | | QueueId | Internal Queue ID | | QueueName | Name of queue | | ResourceAccountObjectId | Value will always be "Null". Property added for future feature. | | OUPath | Organization unit path of the call detail record | | ParentId | Internal ID of the parent record | | From | The name of the IVR or Contact Center Queue that the call was transferred from | | MetServiceLevel | Did the call that met the specified queue service level (True/False) | | AgentName | Name of agent that connected with the caller | | AgentUpn | User principal name of the agent | | AgentId | Internal Agent ID | | AgentAdId | Entra ID object ID of agent | | CallbackRequestId | Internal ID of callback request | | LeaveReason | Reason why the caller disconnected from the queue | | TransferType | Timeout action taken | | TransferToId | ID of the endpoint that the queue transferred to | | TransferToName | The name of the endpoint that the queue transferred to. This could be a user, queue, IVR, or PSTN number. | #### App.IvrWebhook This webhook type sends CDR data that is generated from contact center IVRs. The webhook is triggered after an IVR call has been ended. | Property | Description | | ----------------------- | ---------------------------------------------------------------------------------------------------- | | CallId | Internal Call ID | | ScenarioId | Microsoft Teams Call ID | | CallDirection | Direction of Call (Inbound/Outbound) | | CallerName | Name of Caller | | CallerAdId | Entra ID object ID of caller | | CallerUpn | User principal name of caller | | CallerNumber | Phone number of caller | | StartDateTime | Start date/time of call | | EndDateTime | End date/time of call | | CallLength | Total call length (wait time plus talk time) | | IvrId | Internal IVR ID | | IvrName | Name of IVR | | ResourceAccountObjectId | Value will always be "Null". Property added for future feature. | | OUPath | Organization unit path of the call detail record | | ParentId | Internal ID of the parent record | | From | The name of the IVR or Contact Center Queue that the call was transferred from | | TransferType | Type of Transfer | | TrasnferToId | Transfer destination ID | | TransferToName | Transfer desination Name | | IvrInputs | An array of input data that was collected in the IVR. See properties below: | | ID | Internal Input ID | | InputDateTime | Time of Input | | BlockName | Name of block that collected the data | | ParameterName | Parameter/variable name | | ParameterValue | Contents of Parameter/variable | | BlockType | Type of block that collected the data | | DataValue01 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue02 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue03 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue04 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue05 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue06 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue07 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue08 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue09 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue10 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue11 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue12 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue13 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue14 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue15 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue16 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue17 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue18 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue19 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | | DataValue20 | Value populated in the IVR for this field. See [Data Collection](/administration/data-collection.md) | #### App.AgentWebhook This webhook type sends CDR data that is generated from agents. The webhook is triggered after a call has been ended. | Property | Description | | --------------------- | ------------------------------------------------------------------------------------- | | CallId | Internal Call ID | | ScenarioId | Microsoft Teams Call ID | | CallDirection | Direction of Call (Inbound/Outbound) | | CallerName | Name of Caller | | CallerAdId | Entra ID object ID of caller | | CallerUpn | User principal name of caller | | CallerNumber | Phone number of caller | | StartDateTime | Start date/time of call | | EndDateTime | End date/time of call | | CallLength | Total call length (wait time plus talk time) | | AgentName | Name of agent that connected with the caller | | AgentUpn | User principal name of the agent | | AgentId | Internal Agent ID | | AgentAdId | Entra ID object ID of agent | | InteractionObjectId | Internal queue or IVR ID | | InteractionObjectName | Name of queue or IVR | | OUPath | Organization unit path of the call detail record | | ParentId | Internal ID of the parent record | | AverageSentimentScore | Average Sentiment Score of the call. | | CallState | How the agent interacted with the call. Examples: connected, missed, or rejected. | | IsDirectCall | Was this a direct call. (True/False) | | WrapupTime | Time the agent spent in wrapup | | WrapupData | An array of data that was collected in the wrapup question set. See properties below: | | QuestionId | Internal ID of the question | | Order | Order the questions were presented | | Question | Wrapup question | | Answer | Wrapup question answer | #### App.RecordingWebhook This webhook type sends CDR data that is generated from recordings. The webhook is triggered after a recorded call has been ended. | Property | Description | | ----------------- | -------------------------------------------------------------------------------------------- | | CallId | Internal Call ID | | ScenarioId | Microsoft Teams Call ID | | StartDateTime | Start date/time of call | | EndDateTime | End date/time of call | | CallDirection | Direction of Call (Inbound/Outbound) | | CallLength | Total call length (wait time plus talk time) | | CallerName | Name of Caller | | CallerAdId | Entra ID object ID of caller | | CallerNumber | Phone number of caller | | CallerUpn | User principal name of caller | | CalleeName | Name of Callee | | CalleeAdId | Entra ID object ID of callee | | CalleeUpn | User principal name of callee | | CalleeNumber | Phone number of callee | | OuPath | Organization unit path of the call detail record | | RecordingFileName | Name of recording file in blob storage | | RecordingMode | Recording mode that was applied to the call | | RecordedUserName | Name of user that was recorded | | RecordedUserUpn | User principal name of the user that was recorded | | RecordedUserAdId | Entra ID object ID of the user that was recorded | | Transcription | An array of Transcription phrases that were collected during the call. See properties below: | | SentimentScore | Sentiment score of the phrase | | Phrase | Transcription phrase | | CreationTime | Time when the transcription phrase was created. | ### Webhook History Administration | Webhooks | Select webhook subscription | View Webhook Send Attempts Webhook subscription send attempts show the historical attempts to send the HTTP request to the webhook endpoint URL. ### Troubleshooting Webhooks The Test webhook can be triggered manually for testing purposes. First, add the App.TestWebhook event to a Webhook Subscription. Then on the main webhook page, select the Send Test Webhook button. If a webhook subscription is failing, you can resend a webhook request by browsing to Administration | Webhooks | Select webhook subscription | View Webhook Send Attempts | Resend --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://cc.docs.landis.cloud/administration/webhooks.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.