---
title: "Call Notify"
slug: "call-notify"
updated: 2024-10-25T15:22:12Z
published: 2024-10-25T15:22:12Z
canonical: "docs.voiso.com/call-notify"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiso.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Call Notify

Deprecated

          

This webhook is deprecated. Use the [Call event webhooks](/v1-api/apidocs/call-event-webhooks).

To help agents verify the name and other information about an inbound, outbound, or blind-transferred caller, you can send a request to a CRM that supports the display of a contact information page based on the calling number. The Call Notify webhook sends a message from Voiso to the CRM to enable the CRM to open the contact information page.

The callNotify webhook supports GET and POST request methods.

# Activation To use the Call Notify webhook, you must first enable it in the Voiso System Settings. Navigate to **Administration > System Settings**, and click **Enabled**.

After enabling the Call Notify webhook feature, complete the following configuration settings:

- **URL**: The URL of your CRM API.
- **Authorisation token**: (optional) Requests are sent with the specified token in the request header. The default is blank, meaning no token is sent in the request header.
- **Token prefix**: (optional, required for the token)  Requests are sent with the specified token prefix in the request header. The default is blank; no token prefix is sent in the request header.
- **HTTP request method**: Select either GET or POST. GET is the default selection.

![Call Notify API settings in Administration System Settings](https://res.cloudinary.com/apimatic/image/upload/v1701953937/636bea5ebf3e5a1c4f3fb341/636bea5ebf3e5a1c4f3fb341--APICallNotifySystemSettingsEnableCallNotify2.png)

# Event Voiso sends a GET or POST message to the specified endpoint when an agent gets an **inbound call**, an agent or dialer makes an **outbound call**, or an agent **blind transfers** a call.

## Sent Query

```
{
    "callcenter": "client_name",
    "type": "inbound",
    "uuid": "07771c38-c159-4965-a878-be0162118b2b",
    "agent_extension": "111",
    "agent_name": "John Smith",
    "agent_email": "john@gmail.com",
    "agent_id": 1,
    "queue_name": "Inbound queue name",
    "script_name": "Inbound script name",
    "call_start_time": 1630664544.661,
    "agent_start_time": 1630664545.123,
    "ani": "443336006114",
    "dnis": "18885658889"
}
```

**Example Query:**

```
https://crm.com/endpoint
    ?agent_email=john%40gmail.com
    &agent_extension=111
    &agent_id=1
    &agent_name=John+Smith
    &agent_start_time=1630664545.123
    &ani=443336006114
    &call_start_time=1630664544.661
    &callcenter=client_name
    &dnis=18885658889
    &queue_name=Inbound+queue+name
    &script_name=Inbound+script+name
    &uuid=07771c38-c159-4965-a878-be0162118b2b
```

## Fields

| Name | Type | Description | Value |
| --- | --- | --- | --- |
| callcenter | string | contact center name |  |
| type | call type | string | inbound, outbound, dialer |
| uuid | string | call uuid |  |
| agent_extension | string | user extension number |  |
| agent_name | string | agent name |  |
| agent_email | string | agent email |  |
| agent_id | integer | agent id |  |
| queue_name | string | queue name |  |
| script_name | string | script name |  |
| call_start_time | number | call start time in unix timestamp |  |
| agent_start_time | number | agent call start time in unix timestamp |  |
| ani | string | origination number |  |
| dnis | string | destination number |  |

## Transfers

A new GET request is sent if the call is transferred from one agent to another.

Data from the second agent fill the following fields:

- `agent_extension`
- `agent_email`
- `agent_id`
- `agent_start_time.`

All other data remains the same.