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

# API pública

> Integre seus sistemas com uma chave por organização.

A API v1 permite integrar o disparo com seus sistemas. Cada organização tem uma **chave de API** (criada em **API e webhooks**), e todas as chamadas são feitas no escopo dela.

## Autenticação

Envie a chave no cabeçalho `Authorization: Bearer <chave>`. Cada requisição é limitada por taxa (o limite padrão é por minuto, para proteger a plataforma).

## Endpoints

| Método | Rota | O que faz |
| - | - | - |
| `GET` | `/api/v1/me` | dados da organização (plano, limites) |
| `GET` | `/api/v1/connections` | conexões disponíveis |
| `GET` | `/api/v1/contacts` | lista contatos (filtro por telefone) |
| `POST` | `/api/v1/contacts` | cria ou atualiza o contato pelo telefone |
| `GET` | `/api/v1/campaigns` | lista campanhas |
| `GET` | `/api/v1/campaigns/:id` | resultado de uma campanha |
| `POST` | `/api/v1/messages` | envia uma mensagem avulsa |

<Note>
  Toda chamada de API v1 fica registrada na [auditoria](/docs/organizacao/auditoria).
</Note>

## Enviar mensagem avulsa

`POST /api/v1/messages` envia texto para um número por uma conexão. A API respeita a carência, o descadastro e o bloqueio do WhatsApp, como o disparo em massa: uma mensagem avulsa para chip em carência ou bloqueado é recusada.

Para campanhas em escala, prefira a [API de campanhas](/docs/campanhas/disparo-em-massa); a API pública é ideal para mensagens pontuais e integração com os seus sistemas.