# Documentação do AtendroZAP

Integre instâncias do WhatsApp ao Atendro: gerencie a conexão, envie mensagens e receba eventos no seu próprio webhook.

Esta é a central de documentação de todos os servidores. Use os guias para montar a integração e a referência da API para consultar cada operação, seus campos e suas respostas.

## Comece pela sua integração

1. [Cadastre o servidor e teste o acesso](https://wpp.atendro.cloud/docs/guias/primeiros-passos.md). Confirme a URL da API e o token administrativo.
2. [Crie e conecte uma instância](https://wpp.atendro.cloud/docs/guias/instancias.md). Guarde o ID, o token da instância e o vínculo com a empresa.
3. [Configure o webhook global](https://wpp.atendro.cloud/docs/guias/webhooks.md). Escolha os eventos e um destino para as instâncias desse servidor.
4. [Implemente o receptor no Atendro](https://wpp.atendro.cloud/docs/guias/receber-eventos.md). Valide a assinatura e processe os eventos com idempotência.

## Central, servidor e instância

| Recurso | Endereço ou credencial | Responsabilidade |
|---|---|---|
| Central | `https://wpp.atendro.cloud` | Painel de administração e esta documentação pública |
| API do servidor 1 | `https://1.atendro.cloud` | Operações REST do servidor selecionado |
| Token do servidor | Header `admintoken` | Criar instâncias, consultar capacidades e administrar o webhook global |
| Token da instância | Header `token` | Conectar a instância, enviar mensagens e consultar seus dados |

A URL da central não substitui a URL da API. Cada servidor tem seu próprio endereço e sua própria credencial administrativa.

## Explore a API por recurso

- [Instâncias](https://wpp.atendro.cloud/docs/api/instancias.md): criação, pareamento, status, reinício e exclusão.
- [Enviar mensagens](https://wpp.atendro.cloud/docs/api/envio.md): texto, mídia, contato, localização e menus.
- [Ações em mensagens](https://wpp.atendro.cloud/docs/api/acoes.md): encaminhamento, reação, edição e exclusão.
- [Conversas e consultas](https://wpp.atendro.cloud/docs/api/consultas.md): histórico armazenado, contatos, números e foto de perfil.
- [Webhooks e eventos](https://wpp.atendro.cloud/docs/api/webhooks.md): cadastro global, exceções, entrega e reprocessamento.
- [Grupos](https://wpp.atendro.cloud/docs/api/grupos.md): consulta e operações administrativas de grupo.
- [Referência completa](https://wpp.atendro.cloud/docs/api.md): todos os métodos e caminhos publicados.

## Recursos disponíveis

Consulte `GET /v1/capabilities` no servidor antes de habilitar uma ação no Atendro. A API documentada está em fase `laboratory`: os testes de contrato e a disponibilidade HTTP não substituem a homologação da integração com números autorizados.

**Chamadas de voz usam instâncias de tipo `calls`.** Habilite a interface quando o servidor anunciar `capabilities.calls=true` e a instância de ligação estiver conectada. A instância de mensagens mantém a resposta `501 calls_not_supported`. Consulte o [guia de chamadas de voz](https://wpp.atendro.cloud/docs/guias/chamadas-de-voz.md).

## Documentação para ferramentas e IA

- [OpenAPI 3.1](https://wpp.atendro.cloud/openapi.json): contrato estruturado de requisições e respostas.
- [llms.txt](https://wpp.atendro.cloud/llms.txt): índice por assunto com links para cada guia, endpoint e modelo.
- [llms-full.txt](https://wpp.atendro.cloud/llms-full.txt): conteúdo completo em um único documento de texto.
- Cada página também tem uma versão **Markdown**, acessível pelo link no cabeçalho do conteúdo.