Autenticação
Autenticação
Todas as requisições à API da Talkaio precisam de uma chave de API no cabeçalho Authorization:
Authorization: Bearer tk_sua_chave_aqui
Como gerar sua chave
- Entre na Talkaio com um usuário administrador.
- Vá em Configurações → Integrações.
- No card API, preencha o Nome da chave (ex.: "Site", "CRM") e clique em Criar chave.
- Copie a chave na hora. Ela começa com
tk_e não será exibida novamente.
Não encontrou o card API? O recurso precisa ser habilitado na sua conta. Fale com o suporte.
O que a chave acessa
Uma chave dá acesso à conta inteira: todos os canais, bots, templates, usuários e setores. Guarde-a
como uma senha. Nunca a coloque em código que roda no navegador, como o JavaScript de um site.
Faça as chamadas a partir do seu servidor ou de uma ferramenta de automação.
Gerenciar chaves
No mesmo card você vê cada chave com o nome, o início dela (tk_abc123…), quem criou e o último uso.
Clique em Revogar para desativar uma chave: ela para de funcionar na hora.
As chaves não expiram sozinhas.
Escolhendo o canal
Como a chave vale para a conta toda, as rotas que enviam mensagem ou iniciam bot precisam saber
por qual canal enviar. Informe o channelId no corpo da requisição. Para descobrir os IDs, use
GET /channels. Por enquanto, apenas canais de WhatsApp são aceitos.
Erros de autenticação
| Status | Resposta | Causa |
|---|---|---|
| 401 | {"error": "Authentication token is required"} | Cabeçalho Authorization ausente |
| 401 | {"error": "Invalid API key"} | Chave errada ou revogada |
Updated 3 days ago