Configurações da Conexão
Ao clicar em Editar (ícone de lápis) em qualquer cartão de conexão, o modal de configuração abre. As opções variam conforme o tipo de conexão (Baileys, WABA, Telegram, Z-API).
Este guia descreve todos os campos disponíveis.
Aba Geral
Configurações básicas e de comportamento da conexão.
Campos comuns a todos os tipos
| Campo | Tipo | O que faz |
|---|---|---|
| Nome | Texto | Nome interno para identificar a conexão no painel |
| Cor | Cor | Ponto colorido exibido no cartão (identificação visual) |
| Padrão | Toggle | Define esta como a conexão principal do sistema |
| Permitir grupos | Toggle | Habilita receber mensagens de grupos do WhatsApp |
| Tratar grupos como ticket | Select | Cada mensagem de grupo gera um ticket separado |
| Criar novo ticket em X minutos | Número | Tempo de inatividade após o qual uma nova mensagem do mesmo contato abre um ticket novo |
| Encerrar chats abertos após X minutos | Número | Fecha automaticamente tickets sem resposta após este tempo |
| Encerrar chats quando última mensagem for de | Select | Define quem iniciou a última mensagem para contar o tempo de encerramento (do atendente/cliente ou só do atendente) |
Campos exclusivos Baileys
| Campo | Tipo | O que faz |
|---|---|---|
| Token para integração externa | Texto | Token de acesso para APIs externas identificarem esta conexão |
| Importar mensagens do aparelho | Toggle | Habilita a importação de mensagens históricas ao conectar |
| Data de início da importação | Data | Ponto de partida da importação de histórico |
| Data de término da importação | Data | Fim do período a importar |
| Importar mensagens de grupo | Toggle | Inclui mensagens de grupos na importação |
| Encerrar tickets após importação | Toggle | Fecha automaticamente todos os tickets criados pela importação |
| Fila para importar as mensagens | Select | Fila que receberá os tickets criados pela importação |
Campos exclusivos API Oficial (WABA)
| Campo | Tipo | O que faz |
|---|---|---|
| ID Número de telefone | Texto | ID da Meta para o número de telefone |
| WABA ID | Texto | ID da conta WhatsApp Business na Meta |
| Token de envio | Texto | Token de sistema para autenticação na Meta |
| ID do negócio | Texto | ID do Business Manager na Meta |
| Número de telefone | Texto | Número no formato internacional |
| Chamadas de voz (quem atende) | Toggle | Agente IA atende / Direto para atendentes |
Campos exclusivos Telegram
| Campo | Tipo | O que faz |
|---|---|---|
| Bot Token | Texto | Token do bot gerado pelo @BotFather |
| Webhook URL | Exibição | Endereço gerado automaticamente para configurar no Telegram |
Campos exclusivos Z-API
| Campo | Tipo | O que faz |
|---|---|---|
| Instance ID | Texto | ID da instância no painel Z-API |
| Token | Texto | Token de autenticação Z-API |
| Client-Token | Texto | Client token da Z-API |
| Webhook URL | Exibição | Endereço gerado para configurar na Z-API |
Aba Mensagens
Configura as mensagens automáticas enviadas pela conexão.
| Campo | O que faz |
|---|---|
| Mensagem de saudação | Enviada quando um cliente abre uma nova conversa |
| Mensagem de conclusão | Enviada quando um ticket é encerrado |
| Mensagem de fora de expediente | Enviada quando o cliente contata fora do horário configurado |
| Mensagem de inatividade | Enviada quando o cliente fica sem responder por X minutos |
| Tempo para inatividade (minutos) | Tempo de silêncio antes de enviar a mensagem de inatividade |
| Mensagem de encerramento por inatividade | Mensagem final antes de fechar o ticket por inatividade |
| Link para política de privacidade (LGPD) | URL exibida na saudação LGPD |
| Mensagem de saudação LGPD | Mensagem com aviso de privacidade |
| Ofuscar mensagem apagada pelo contato | Oculta o conteúdo de mensagens que o cliente apagou |
| Sempre solicitar confirmação do contato | Exige confirmação LGPD antes de iniciar o atendimento |
| Mensagem de férias coletivas | Mensagem alternativa durante o período de férias |
| Data inicial / Data final das férias | Período em que a mensagem de férias é enviada |
Aba Integrações
Vincula a conexão a sistemas externos de automação.
| Campo | O que faz |
|---|---|
| Fila | Fila padrão para redirecionamento |
| Tempo para redirecionar à fila (minutos) | Tempo sem atendente antes de redirecionar |
| Habilitar Integração | Ativa/desativa a integração configurada |
| Disparar Integração ao Encerrar Ticket | A integração também é chamada quando o ticket fecha |
Integrações disponíveis (conforme configuração da plataforma): n8n, Typebot, Webhook externo, FlowBuilder.
Aba Chatbot
Configura o comportamento do bot automático nesta conexão.
| Campo | O que faz |
|---|---|
| Enviar bot X vezes | Quantas vezes o bot pode enviar sua mensagem na mesma sessão |
| Enviar bot em X minutos | Intervalo mínimo entre envios do bot |
| Tempo para retornar à fila (minutos) | Após o bot responder, quanto tempo esperar antes de abrir para atendente |
| Enviar flow de inatividade X vezes | Quantas vezes o flow de inatividade é disparado |
| Tempo para aguardar ativação do fluxo (minutos) | Espera antes de acionar o flow de inatividade |
Aba NPS (Avaliações)
Configura a pesquisa de satisfação ao final dos atendimentos.
| Campo | O que faz |
|---|---|
| Mensagem de avaliação | Texto enviado ao cliente pedindo nota de 0 a 10 |
| Encerrar chats aguardando avaliação após X minutos | Fecha tickets que ficaram esperando resposta da avaliação |
| Quantidade máxima de envios da avaliação | Evita reenviar o formulário indefinidamente |
Aba Fluxo Padrão
Permite associar um FlowBuilder como fluxo padrão desta conexão. O fluxo é acionado quando nenhuma outra regra se aplica.
Aba Horário de Expediente
Define os dias e horários em que a conexão aceita atendimentos. Fora do expediente, a mensagem de "fora de expediente" é enviada automaticamente.
Configuração por dia da semana:
- Segunda a sexta (dias úteis)
- Sábado
- Domingo
Para cada dia: horário de início, horário de fim e opção de desativar o dia.
Problemas comuns
Salvou as configurações mas a mensagem de saudação não está sendo enviada
- Verifique se a conexão está com status Conectado
- Verifique se o campo "Mensagem de saudação" não está em branco
O encerramento automático por inatividade não está funcionando
- Certifique-se de que o campo "Encerrar chats abertos após X minutos" tem um valor maior que zero
- O tempo conta a partir da última mensagem trocada, não do início do ticket
Quero que o bot envie apenas uma vez por sessão
- Defina "Enviar bot X vezes" como
1