Integrações
Typebot
Conecte fluxos do Typebot ao Jarvis, receba dados do contato e use comandos para transferir, etiquetar e encerrar.
O Typebot é um construtor de chatbots externo. Com a integração, seus fluxos publicados conversam com os clientes pelo WhatsApp e demais canais do Jarvis.
Criar a integração#
- Automação e Integrações → IA e Integrações → Adicionar → Typebot.
- Siga o assistente (nome, configuração, revisão).
- No assistente de ativação, o sistema cria uma fila que inicia o Typebot ao transferir. Escolha os canais.
Campos#
| Campo | O que preencher |
|---|---|
| URL da integração | O endereço do seu Typebot publicado, sem a barra final |
| Slug | O nome do fluxo que aparece na URL após publicar |
| Tempo para expirar a conversa (min) | Inatividade até o Jarvis desconectar o cliente do Typebot |
| Palavra que fecha o ticket | Ex.: #sair |
| Mensagem de opção inválida | Resposta quando o cliente digita algo inesperado |
| Palavra que reinicia o fluxo e mensagem ao reiniciar | Ex.: #menu |
| Título de botões / lista, subtítulo e texto do botão da lista | Usados na API Oficial e no WhatsApp Plus (até 3 opções viram botões; mais que isso, lista) |
| Intervalo entre mensagens (ms) | 1000 = 1 segundo |
Variáveis recebidas#
Crie no Typebot variáveis com estes nomes para receber os dados do Jarvis:
number, pushName, nome, email, ticketId, protocol, ticket, remoteJid e firstMessage.
As informações adicionais do contato também chegam (ex.: CPF, plano, endereco). Elas são carregadas no início; se mudarem durante o fluxo, só são atualizadas ao reiniciar.
Comandos#
Coloque o comando dentro de um bloco de texto do Typebot, trocando os IDs pelos do Jarvis (os IDs aparecem nas telas de cadastro):
| Ação | Chave usada |
|---|---|
| Transferir para fila | queueId |
| Transferir para atendente | queueId + userId |
| Transferir para o chatbot interno | chatbotId |
| Parar o Typebot | stopBot |
| Adicionar etiqueta | tagId |
| Encerrar o atendimento | closeTicket |
| Colocar no Kanban (compartilhado) | crmId |
Colocar em um follow-up (0 remove) |
followupId |
| Criar/alterar informação adicional | AddiInfo com description e information |
Exemplo de bloco de texto para transferir para a fila 3:
{"queueId": 3}
Mensagens interativas#
Também por blocos de texto, você pode enviar lista personalizada, botões de resposta, botão com link, pedido de localização, botão dinâmico, carrossel, botão PIX, solicitação de pagamento, localização e contato. Botões, listas e pedido de localização exigem API Oficial ou WhatsApp Plus; carrossel, botão dinâmico, PIX e solicitação de pagamento exigem WhatsApp Plus.