Documentação do AtendroZAP
Guias, referência da API e eventos para implementar sua integração.
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
- Cadastre o servidor e teste o acesso. Confirme a URL da API e o token administrativo.
- Crie e conecte uma instância. Guarde o ID, o token da instância e o vínculo com a empresa.
- Configure o webhook global. Escolha os eventos e um destino para as instâncias desse servidor.
- Implemente o receptor no Atendro. 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: criação, pareamento, status, reinício e exclusão.
- Enviar mensagens: texto, mídia, contato, localização e menus.
- Ações em mensagens: encaminhamento, reação, edição e exclusão.
- Conversas e consultas: histórico armazenado, contatos, números e foto de perfil.
- Webhooks e eventos: cadastro global, exceções, entrega e reprocessamento.
- Grupos: consulta e operações administrativas de grupo.
- Referência completa: 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.
Documentação para ferramentas e IA
- OpenAPI 3.1: contrato estruturado de requisições e respostas.
- llms.txt: índice por assunto com links para cada guia, endpoint e modelo.
- 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.