Skip to main content
A Conexão via API transforma o Talk em um canal acessível pelos seus próprios sistemas: você consegue enviar e receber mensagens, criar contatos, iniciar conversas e consultar dados via REST. A página gerencia os tokens de API que autenticam essas chamadas. A página fica em Configurações → Canais → Conexão via API (talk.saninternet.com/settings/channels/api).
Para a referência completa de endpoints, autenticação, payloads e códigos de erro, veja a API Reference.

​
Como funciona

Cada token é uma credencial pessoal-de-aplicação (não está vinculada a um usuário humano) que autentica requisições à API REST do Talk. Você cria quantos tokens precisar — um por integração, por exemplo — e revoga individualmente quando alguma chave vaza ou um sistema antigo é desativado. A autenticação segue o padrão Bearer Token no header HTTP: 
Authorization: Bearer <seu-token>
O token completo aparece uma única vez, no momento da criação. Depois disso, o Talk mostra apenas uma versão mascarada (ex.: talk_••••••••a1b2). Se você perder o token, terá que gerar um novo.

​
Criar um token

1

Abra o modal de criação

Clique em Criar Token no canto superior direito da página (ou no botão central, no estado vazio).
2

Preencha os dados

  • Nome (obrigatório) — identificador curto, ex.: Integração ERP, Webhook Site.
  • Descrição (opcional) — texto livre para você lembrar o propósito do token.
3

Copie o token

Após a criação, um modal exibe o token completo. Copie e guarde em local seguro (cofre de senhas, variável de ambiente do servidor, gerenciador de segredos).
Este é o único momento em que o valor completo fica visível. Ao fechar o modal, o Talk passa a exibir apenas a versão mascarada.

​
Ver e gerenciar tokens

A página lista todos os tokens criados pela Empresa em cards, com:
CampoDescrição
NomeIdentificador do token.
Ícone de statusVerde (ativo) ou vermelho (inativo).
DescriçãoTexto opcional inserido na criação.
TokenValor mascarado (ex.: talk_••••••••a1b2).
Último usoData e hora da última requisição autenticada, ou “Nunca” se nunca foi usado.
Criado emData e hora da geração.

​
Excluir um token

Cada card tem um botão vermelho de lixeira. Clicar abre uma confirmação — ao confirmar, o token é revogado imediatamente e qualquer requisição que tentar usá-lo passa a receber 401 Unauthorized.
Não há “desativação” — apenas exclusão. Antes de remover, certifique-se de que nenhum sistema crítico ainda está usando aquele token.

​
Boas práticas

  • Um token por integração: se três sistemas conversam com o Talk, crie três tokens. Assim, ao desativar um sistema, você revoga só o token dele.
  • Nome descritivo: use prefixos como prod-, staging-, webhook- para distinguir rapidamente.
  • Rotação periódica: gere um token novo, atualize a integração, valide funcionamento e só então revogue o antigo. Recomenda-se rotacionar a cada 90 dias.
  • Não comite tokens: nunca deixe um token em código aberto, repositório git ou ticket de suporte. Use variáveis de ambiente ou um gerenciador de segredos.
  • Acompanhe “Último uso”: tokens com mais de 30 dias sem uso provavelmente podem ser revogados.

​
Quem pode gerar tokens

Apenas usuários Proprietário da Empresa têm permissão para criar e revogar tokens de API. Gestores, Gerentes e Atendentes não veem a página de Conexão via API.
Para começar a integrar, comece pelo endpoint de autenticação e pelo guia de erros padronizados da API.