Guia/SendApp Agent/Relatórios e API
Chaves de API e webhooks
Se queres integrar o SendApp Agent com os teus sistemas (software de gestão, CRM, automações), a API é o caminho. Aqui encontras como te autenticar, o que podes fazer e como receber os eventos recebidos através de webhooks. É um guia técnico, mas com os conceitos explicados passo a passo.
Atualizado em 16 de junho de 2026 · 6 min de leitura
Antes de começar
- Uma conta SendApp Agent com acesso à API previsto pelo plano
- Conhecimentos básicos sobre pedidos HTTP
Obter a chave de API
- 1
Abre a secção “API”
No menu abre API: aqui encontras a chave de programador (apikey) da tua conta.
- 2
Copia a chave
Usa-a para autenticar os teus pedidos. Trata-a como uma palavra-passe.
Como autenticar-se
- URL base
- A API está no domínio da tua conta, com o prefixo /api (ex.: https://o-teu-dominio/api). Não uses “/v1” nem domínios diferentes.
- Autenticação
- Passa a chave no cabeçalho HTTP “X-API-Key”, ou como parâmetro “apikey” no pedido. Não se usa o bearer token.
Não partilhes a chave de API e não a inseras em código público (ex.: JavaScript no lado do navegador): quem tem a chave pode agir na tua conta. Se ficar exposta, regenera-a.
O que podes fazer via API
- Enviar mensagens (ex.: através do endpoint de envio do WhatsApp), dentro dos limites das regras do canal (na API oficial da Meta, para escrever primeiro é necessário um template aprovado).
- Gerir os contactos da lista.
- Criar uma nova Conta (bot) de forma programática.
- Registar o URL do teu webhook para receber os eventos recebidos.
Os endpoints que aceitam a chave funcionam tanto com a conta titular como com um operador autorizado: atribui as chaves com critério consoante quem tem de fazer a integração.
Webhooks: receber os eventos
Com os webhooks recebes em tempo real os eventos recebidos (ex.: uma nova mensagem de um canal). Registas o URL do teu endpoint através da API: a partir desse momento o SendApp envia os dados ao teu sistema quando o evento ocorre. É a forma de manter alinhado um CRM ou um software de gestão externo.
Erros comuns
- 401 / não autorizado
- Chave em falta ou errada: verifica o cabeçalho X-API-Key ou o parâmetro apikey.
- URL errado
- Usa o domínio da tua conta com o prefixo /api, sem “/v1”.
- Demasiados pedidos num endpoint
- Alguns endpoints têm um limite de frequência: distribui as chamadas em vez de as concentrar.
Pronto para pôr em prática?
Abre o SendApp e segue os passos deste guia. Precisas de ajuda? O suporte está a uma mensagem de distância.