Integrações e API

Integrações (Typebot, n8n e outras)

Em Integrações você cadastra fluxos externos que conduzem a conversa antes ou no lugar da equipe. Tipos aceitos: Typebot, n8n, Dialogflow e webhooks.

Tela de Integrações

Para o Typebot, os campos principais são o slug do fluxo, o tempo para expirar a conversa, a palavra para finalizar o ticket, a palavra para reiniciar o fluxo, a mensagem ao reiniciar, a mensagem de opção inválida e o intervalo entre mensagens. O botão Testar Bot confere a integração.

Depois de criada, a integração é ligada a uma fila ou a uma conexão. Enquanto o fluxo conduz, o card mostra "Atendimento em automação ativa" e o atendente pode Destravar para assumir.

Prompts (Open.Ai)

A tela Open.Ai (Prompts) é a integração legada com a OpenAI: cada prompt tem nome, texto do prompt, API Key própria, modelo GPT, máximo de tokens, temperatura e máximo de mensagens no histórico, e é ligado a uma fila ou conexão. Para a IA nova do Bora, use a IA Config.

API de mensagens

Em API (Administrativo) está a documentação para integrar sistemas externos, como alertas, Mikrotik e automações. A conexão é identificada pelo token da conexão (copiado na edição da conexão).

Tela da API

Ação	Endpoint	Observação
Enviar texto	POST /api/messages/send	JSON com number (só dígitos, com DDI), body, destination (auto, tickets ou leads) e closeTicket
Enviar arquivo	POST /api/messages/send	multipart/form-data com o arquivo
Transferir ticket	POST /api/tickets/transfer	Para fila e/ou usuário, por ticket, contato ou número
Destravar ticket	POST /api/tickets/unlock	Libera ticket travado por integração

Mandando só a fila na transferência, um ticket fechado não é reaberto, apenas atualizado. A tela traz exemplos de cURL prontos para copiar e a lista de códigos de erro.