# Set-up Webhook

Webhook allows you to receive real-time HTTP notifications from Whatsapp Business Numbers such as inbound Message notifications and delivery status notifications. For example, when your customers send you a message we will notify your webhook or when you send message to your customers the delivery status will be notified to your webhook whether the message already delivered, read, or even failed.

#### Understanding Webhooks

Whenever event in your Whatsapp Business Number occurs, it will send you a notification via your Webhook URL. You must provide URL that can be reached via `HTTPS` a connection and have already configured in our system. To configure your webhook make <mark style="color:red;">`POST`</mark> request to **`/{{Channel-ID}}/webhook`**

Sample request to configure webhook using `Curl`

```
curl --location 'https://wa-api.neuapix.com/whatsapp/v3/{{Channel-ID}}/webhook' \
--header 'Authorization: Bearer {{place your token herer}}' \
--header 'Content-Type: application/json' \
--data '{
    "webhooks": {
        "url": "https://your-webhook.com/webhoo"
    }
}'

```

Successful response:

```json
{
    "success":true
}
```

There are two types of notifications you will get

1. **Received Messages:** This type of notification will send you message of your customer to your webhook when customers interact with your Whatsapp Business Numbers, it is also called "Inbound Notification". See [message payload here](/whatsapp-api/whatsapp-api/set-up-webhook/received-messages.md)
2. **Message Status:** Whenever you send a message, you will get the current status of your message whether it is delivered, read, or failed. this type of notification is also called "Outbound Notification". See [status payload here](/whatsapp-api/whatsapp-api/set-up-webhook/message-status.md)


---

# 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://docs-wa.neuapix.com/whatsapp-api/whatsapp-api/set-up-webhook.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.