# 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 
        } 
    }] 
} 
 
```


---

# 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://wadocs.pepipost.com/webhooks/overview/incoming-message.md?ask=<question>
```

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.