API de Parceiros
Integre o assistente TAU aos seus sistemas, canais e experiências digitais.
API de Parceiros
A API de Parceiros da TAU permite conectar o assistente aos sistemas que já fazem parte da sua operação. Com ela, sua aplicação pode enviar mensagens, manter o contexto de cada conversa e consultar atendimentos sem depender de uma interface manual.
Ela é indicada para parceiros e clientes que precisam criar uma integração própria, como um aplicativo, portal, CRM, central de atendimento ou canal digital.
A URL de produção é https://partners-api.taubot.ai. A referência interativa, com os formatos completos de requisição e resposta, está disponível em partners-api.taubot.ai/docs.
O que você pode integrar
- Envio de mensagens para o assistente, individualmente ou em lote
- Continuidade da conversa entre mensagens e canais autorizados
- Consulta da lista de conversas e do histórico de mensagens
- Controle do estado do assistente em um atendimento
- Consulta do estado de uma conversa
- Verificação da conexão do WhatsApp
- Tratamento de texto e mídias nos fluxos compatíveis
As operações disponíveis dependem das permissões concedidas à sua chave de API.
Como funciona
- No painel TAU, abra o assistente e acesse Configurações → Chaves de API.
- Gere uma chave e selecione somente os escopos necessários para a integração.
- Seu servidor envia a chave no cabeçalho
Authorization. - A primeira mensagem cria ou recupera o cliente e inicia uma conversa.
- A resposta devolve um
chat_id, que deve ser enviado nas próximas mensagens para manter o contexto. - Quando necessário, sua aplicação pode consultar conversas, histórico e status pelos endpoints autorizados.
A chave de API deve ficar somente no seu servidor. Nunca inclua a chave em JavaScript público, aplicativos distribuídos, repositórios ou logs.
Antes de começar
Você precisa ter:
- Um assistente TAU ativo
- Acesso às configurações desse assistente
- Uma chave de API gerada com os escopos necessários
- O identificador do assistente usado na URL da integração
- Um backend capaz de fazer requisições HTTPS
A geração da chave é feita pelo próprio cliente nas configurações do assistente.