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

# Campanhas

> Como acompanhar campanhas de disparo via API

# Campanhas

O recurso `campaigns` permite acompanhar campanhas e seus disparos.

## Listar campanhas

```bash theme={null}
curl "https://api.synax.app.br/functions/v1/api-proxy/campaigns?order=created_at.desc" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui"
```

## Consultar disparos de uma campanha

```bash theme={null}
curl "https://api.synax.app.br/functions/v1/api-proxy/dispatches?campaign_id={campaign_id}&limit=50" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui"
```

### Status dos disparos

| Status    | Descrição                                      |
| --------- | ---------------------------------------------- |
| `pending` | Aguardando envio                               |
| `sent`    | Enviado com sucesso                            |
| `failed`  | Falha no envio                                 |
| `ignored` | Ignorado (contato opt-out, sem WhatsApp, etc.) |

<Info>
  A criação de campanhas é feita pelo app. A API permite consulta e acompanhamento.
</Info>