API de Parceiros

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

  1. No painel TAU, abra o assistente e acesse Configurações → Chaves de API.
  2. Gere uma chave e selecione somente os escopos necessários para a integração.
  3. Seu servidor envia a chave no cabeçalho Authorization.
  4. A primeira mensagem cria ou recupera o cliente e inicia uma conversa.
  5. A resposta devolve um chat_id, que deve ser enviado nas próximas mensagens para manter o contexto.
  6. 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.

Próximos passos

On this page