# Incoming message-text

## Webhook Incoming Message - Text

This webhook sends incoming message as and when user send a text message When user gives a reply to a previous message then context will be provided.

Method: POST

Parameters:

| Parameter     | Description                                                                       | Data Type   |
| ------------- | --------------------------------------------------------------------------------- | ----------- |
| ncmessage\_id | ncmessage\_id is unique id which is given when you send any message via PUSH api. | String      |
| message\_id   | Unique message id                                                                 | String      |
| received\_at  | The time of status. The time when the message is received                         | Date - Time |
| mesage\_type  | The type of message will be “text”                                                | String      |
| text          | Text message from user.                                                           | String      |
| from          | The user mobile number                                                            | number      |

### Webhook Payload

```
{
"incoming_message": [{
"message_id": "ABEGkZlgQyWAAgo-sDVSUOa9jH0z",
"from": "919960432580",
"received_at": "1567090835",
"context": {
"ncmessage_id": null,
"message_id": null
},
"message_type": "TEXT",
"text_type": {
"text": "hello"
}
}]
}
```

## Webhook Incoming Message - Media

This webhook send incoming message as and when user send a media message. Media message can be 3 type -

* Image
* Audio
* Video

  When user gives a reply to a previous message then context will be provided.

Method: POST

Parameters:

| Parameter     | Description                                                                                       | Data Type   |
| ------------- | ------------------------------------------------------------------------------------------------- | ----------- |
| ncmessage\_id | ncmessage\_id is unique id which is given when you send any message via PUSH api.                 | String      |
| message\_id   | Unique message id                                                                                 | String      |
| received\_at  | The time of status. The time when the message is received                                         | Date - Time |
| mesage\_type  | <p></p><p>The type of message will be -</p><ul><li>IMAGE</li><li>VIDEO</li><li>DOCUMENT</li></ul> | String      |
| id            | This will be media id. You can get the media from Media API.                                      | String      |
| caption       | This will contain the caption of file name                                                        | String      |
| from          | The user mobile number                                                                            | number      |

### Webhook Payload

```
{
"incoming_message": [{
"message_id": "ABEGkZlgQyWAAgo-sOme7WUxlHHq",
"from": "919960432580",
"received_at": "1567091670",
"context": {
"ncmessage_id": null,
"message_id": null
},
"message_type": "IMAGE",
"image_type": {
"sha256":
"dd04cf3f58d890729201bbfa100c22ba02ab2a9353de793eddaf9fbbfda
c9cbb",
"mime_type": "image\/jpeg",
"id": "aa41ac0d-2eb4-4d4a-a212-03f3c0e2001d"
}
}]
}
```

## Webhook Incoming message- Location

This webhook send incoming message as and when user send a location.

Location data will contain lat and long.

When user gives a reply to a previous message then context will be provided.

Method: POST

Parameters:

| Parameter     | Description                                                                       | Data Type   |
| ------------- | --------------------------------------------------------------------------------- | ----------- |
| ncmessage\_id | ncmessage\_id is unique id which is given when you send any message via PUSH api. | String      |
| message\_id   | Unique message id                                                                 | String      |
| received\_at  | The time of status. The time when the message is received                         | Date - Time |
| mesage\_type  | The type of message will be “location”                                            | String      |
| latitude      | The latitude of location                                                          | String      |
| longitude     | The longitude of location                                                         | String      |
| from          | The user mobile number                                                            | number      |

### Webhook Payload

```
{ 
    "incoming_message": [{ 
        "message_id": "ABEGkZlgQyWAAhC3CZb1ttzQo0mvQBbL2pFk", 
        "from": "919960432580", 
        "received_at": "1567092229", 
        "context": { 
            "ncmessage_id": null, 
            "message_id": null 
        }, 
        "message_type": "LOCATION", 
        "location_type": { 
            "address": "Dosti Pinnacle, Unit No. G1, Plot No. E7, Th\u0101ne, 
Mah\u0101r\u0101shtra 400604", 
            "latitude": 19.198988196033, 
            "name": "Passport Seva Kendra", 
            "url": "http:\/\/www.passportindia.gov.in", 
            "longitude": 72.948932751057 
        } 
    }] 
} 
 
```