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

# Webhook de Status de Mensagem

> Configura URL que recebe atualizações de status das mensagens enviadas

## Descrição

Configura a URL do seu servidor que receberá atualizações de status das mensagens enviadas pela instância. Cada vez que o status de uma mensagem mudar, uma notificação será enviada para a URL configurada.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "value": "https://seusite.com/webhook/message-status"
}
```

| Campo   | Tipo   | Obrigatório | Descrição                                                  |
| ------- | ------ | ----------- | ---------------------------------------------------------- |
| `value` | string | Sim         | URL do seu servidor que receberá as atualizações de status |

## Response

### Sucesso (200)

```json theme={null}
{
  "success": true
}
```

## Status de Mensagem

| Status      | Descrição                    |
| ----------- | ---------------------------- |
| `pending`   | Mensagem enfileirada         |
| `sent`      | Mensagem enviada ao servidor |
| `delivered` | Entregue ao destinatário     |
| `read`      | Lida pelo destinatário       |
| `failed`    | Falha no envio               |

## Exemplo cURL

```bash theme={null}
curl -X PUT 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/update-webhook-message-status' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"value": "https://seusite.com/webhook/message-status"}'
```