Conectar e configurar canais de atendimento (Integrações)
Permite conectar canais como WhatsApp, Instagram, Facebook Pages e Chat Widget, ver o status e ajustar regras importantes do atendimento da IA (horário, mensagens e comportamento do canal).
Para que serve
Use para conectar os canais de atendimento da empresa (como WhatsApp, Instagram e Facebook) e deixar as conversas centralizadas.
Também permite ajustar:
- Horário de atendimento da IA
- Mensagem automática fora do horário
- Configurações por canal (IA ativa/desativada, base de conhecimento, distribuição, etc.)
Resumo rápido
- Clique em Nova integração (ou Conectar meu primeiro canal de atendimento).
- Escolha um tipo de canal (ex.: Whatsapp Qr-Code, Instagram, Facebook Pages, Chat Widget).
- Para WhatsApp por QR: clique em Gerar QR Code para conectar e escaneie pelo celular.
- Confira o status do canal: Ativo ou Desconectado (pode usar Reconectar).
- Ajuste o Horário de atendimento da IA e salve quando necessário.
- Abra as configurações do canal e clique em Salvar para aplicar as mudanças.
Resultado esperado: Canal conectado e aparecendo como Ativo, com as configurações salvas para o atendimento.
Como conectar um canal e deixar pronto para uso
Iniciar uma nova conexão
Clique em Nova integração.
Se ainda não existir nenhum canal, clique em Conectar meu primeiro canal de atendimento.
Conectar WhatsApp por QR Code (opção mais direta)
Em Whatsapp Qr-Code, clique em Gerar QR Code para conectar.
Aguarde aparecer o QR Code (pode levar um pouco).
Escanear o QR Code pelo celular
Siga as instruções:
1. Abra o WhatsApp no celular.
2. Toque em Mais opções (Android) ou Configurações (iPhone).
3. Toque em Dispositivos conectados e depois Conectar dispositivo.
4. Aponte o celular para escanear o QR code.
Se o QR Code travar ou demorar demais
Quando aparecer o botão de recarregar (ícone de recarregar), toque nele para gerar outro QR Code.
Se aparecer alerta de erro, tente novamente mais tarde.
Confirmar que conectou
Procure o canal na lista.
Quando estiver conectado, o status mostra Ativo.
Se aparecer Desconectado, use Reconectar.
Definir o horário de atendimento da IA (quando necessário)
Em Horário de atendimento da IA: selecione uma opção:
- 24 Horas por dia
- Estará Aberto nos Horários abaixo
- Estará Fechado nos Horários abaixo
Depois marque os dias e ajuste os horários.
Se aparecer o botão Salvar Horário de Atendimento, clique nele.
Definir mensagem fora do horário (opcional)
Preencha Mensagem automática quando estivermos fora do horário:.
Para desativar essa mensagem, deixe em branco (o próprio texto informa isso).
Ajustar as configurações do canal e salvar
Dentro do canal, ajuste itens como Modo de funcionamento, Base de conhecimento e Apelido e cor do canal.
No final, clique em Salvar (botão do canal) para aplicar.
Campos principais (o que preencher e o que muda na prática)
Horário de atendimento da IA:
edit_noteseleçãoValor padrão: 24 Horas por dia
Descrição: Escolha quando a IA atende.
Se selecionar 24 Horas por dia, não aparece a grade de dias/horas.
Se selecionar Estará Aberto nos Horários abaixo ou Estará Fechado nos Horários abaixo, marque os dias e horários para controlar o funcionamento.
Regras/validações: Opções visíveis:
- 24 Horas por dia
- Estará Aberto nos Horários abaixo
- Estará Fechado nos Horários abaixo
Exemplos: - Para atender sempre: 24 Horas por dia
- Para atender só em horário comercial: Estará Aberto nos Horários abaixo
Mensagem automática quando estivermos fora do horário: (Deixe em branco para desativar)
edit_notetexto longoDescrição: Digite uma mensagem que aparece quando estiver fora do horário configurado.
Para não enviar mensagem nenhuma fora do horário, deixe o campo vazio.
Regras/validações: O próprio texto informa: Deixe em branco para desativar.
Exemplos: - "No momento estamos fora do horário. Retornamos no próximo dia útil."
Modo de funcionamento
edit_noteseleçãoDescrição: Define como a IA se comporta neste canal.
Use IA Ativa para a IA responder.
Use IA Modo simulação para simular.
Use IA Desativada para não responder automaticamente.
Regras/validações: Opções visíveis:
- IA Ativa
- IA Modo simulação
- IA Desativada
Exemplos: - Para colocar a IA para atender: IA Ativa
- Para pausar a IA: IA Desativada
Base de conhecimento
edit_noteseleçãoValor padrão: Selecione
Descrição: Escolha uma base para a IA usar nas respostas.
Use o botão com lápis para editar a base escolhida.
Use o botão com + para criar uma nova.
Regras/validações: Enquanto estiver em Selecione, o campo aparece com destaque.
Lista mostra nomes como desc_prompt_nickname (nome da base).
Exemplos: - "Dúvidas frequentes"
- "Produtos e preços"
Apelido e cor do canal
edit_notetexto + seleção (cor)Descrição: Dê um nome curto para identificar o canal e escolha uma cor no botão com ícone de paleta.
Isso ajuda a reconhecer o canal mais rápido na lista.
Regras/validações: Placeholder visível: Insira um apelido para este canal.
Exemplos: - Apelido: "WhatsApp Loja"
- Apelido: "Instagram Suporte"
Mensagem de Saudação Fixa
edit_notetextoDescrição: Mostra um texto fixo ao iniciar o chat.
O próprio texto informa: deixar vazio desativa.
Esse campo aparece quando o canal é widget ou quando IA Desativada está selecionado.
Regras/validações: Subtexto visível: Deixe em branco para desativar.
Placeholder visível: Texto exibido ao iniciar o chat.
Exemplos: - "Olá! Como posso ajudar?"
Texto Widget
edit_notetextoDescrição: Define o título do chat do Chat Widget.
Esse campo aparece quando o canal é widget.
Regras/validações: Placeholder visível: Título do chat.
Limite visível: maxlength="25" (até 25 caracteres).
Exemplos: - "Abrir Chat"
- "Fale com a gente"
Imagem Widget ( Recomendado: 80 x 80)
edit_noteuploadDescrição: Escolha uma imagem para o Chat Widget.
Use Carregar Imagem ou Carregar outra Imagem.
Para remover a imagem, clique em Remover Arquivo.
Regras/validações: Aceita imagem (texto visível: accept="image/*").
Recomendação visível: 80 x 80.
Exemplos: - Logo da empresa (quadrado)
- Foto do suporte (quadrada)
Direcionar conversas para o departamento
edit_noteseleçãoDescrição: Escolha um departamento para novas conversas deste canal já entrarem com esse vínculo.
Quando selecionar um departamento, pode aparecer um aviso sobre a base de conhecimento.
Regras/validações: Opção visível: Nenhum.
Aviso possível: A base de conhecimento do departamento selecionado irá substituir a base definida no canal.
Exemplos: - "Nenhum" (não direciona)
- "Suporte" (quando existir na lista)
Resolver conversa após:
edit_notenúmeroDescrição: Define em quantas horas uma conversa pode ser resolvida automaticamente.
Para desligar a resolução automática, use 0 (texto visível informa isso).
Observação: o texto informa que isso vale para conversas no modo IA ATIVA.
Regras/validações: Mostra Horas ao lado.
Texto visível: Defina 0 para desativar a resolução automática.
Texto visível: Apenas conversas no modo IA ATIVA são resolvidas automaticamente.
Exemplos: - 0 (desativa)
- 72 (3 dias)
Reativar IA em conversas abandonadas após:
edit_notenúmeroDescrição: Use quando um atendente para de responder.
Depois do tempo definido, a IA pode ser reativada automaticamente.
Para desativar, use 0 (texto visível informa isso).
Regras/validações: Mostra Horas ao lado.
Texto visível: Defina 0 para desativar essa reativação automática.
Exemplos: - 0 (desativa)
- 2 (reativa após 2 horas sem interação)
Considerar conversa em atraso após:
edit_notenúmeroDescrição: Define depois de quantos minutos sem resposta a conversa aparece como "em atraso".
Use um número que combine com o ritmo do atendimento.
Regras/validações: Mostra Minutos ao lado.
Texto visível: Define em quantos minutos (sem resposta) a conversa será listada como "em atraso".
Exemplos: - 15 (marcar rápido)
- 30 (padrão comum)
Termos que aparecem e podem confundir
- IA Ativa / IA Modo simulação / IA Desativada: IA Ativa: atende de verdade.
IA Modo simulação: simula.
IA Desativada: não responde automaticamente.
Exemplo: escolher IA Desativada para deixar só atendimento humano. - Base de conhecimento: Lista de informações que a IA usa para responder.
Exemplo: uma base chamada "Produtos" para responder dúvidas sobre preços. - Distribuição dinâmica: Opção para distribuir conversas automaticamente.
Pode ser para atendentes online ou em horários determinados (opções aparecem na lista). - Contatos autorizados: Modo em que a IA responde somente para contatos permitidos.
Também existe uma Mensagem enviada para contatos não autorizados. - Chat Widget: Um chat que pode ser adicionado em um site.
Depois de criar, aparece o botão Copiar Script.
Regras e limites importantes (visíveis no recurso)
- Para mensagem fora do horário: Deixe em branco para desativar.
- Para saudação fixa: Deixe em branco para desativar.
- Em Resolver conversa após:, usar 0 para desativar a resolução automática.
- Em Reativar IA em conversas abandonadas após:, usar 0 para desativar a reativação automática.
- Em horários por dia (atendimento): quando a hora inicial passa da final (ou o contrário), o horário é ajustado automaticamente para não ficar invertido.
- No Texto Widget, existe limite de 25 caracteres.
- Para Imagem Widget, a recomendação é 80 x 80 e o arquivo precisa ser uma imagem.
Erros e dúvidas comuns (e como resolver)
Causa provável: Falha ao gerar o QR Code no momento.
Como corrigir: - Feche a conexão atual.
- Tente novamente usando Gerar QR Code para conectar.
- Se o problema continuar, aguarde e tente mais tarde.
Como confirmar: O QR Code aparece no local do QR, e o canal muda para Ativo depois do escaneamento.
Causa provável: A autorização foi concluída, mas não veio nenhuma conta/número liberado para conectar.
Como corrigir: Clique em Tentar conectar novamente.
Siga a orientação exibida no aviso:
- Refazer a conexão usando o Facebook administrador
- Selecionar o negócio correto, a conta correta e o número
- Aceitar as permissões relacionadas ao WhatsApp Business
Como confirmar: A conexão volta a abrir, e depois um canal aparece na lista com status Ativo.
Causa provável: O navegador bloqueou a cópia para a área de transferência.
Como corrigir: - Tente clicar em Copiar Script novamente.
- Se estiver em janela anônima ou com bloqueios, tente em uma janela normal.
- Se houver permissão do navegador para copiar, permita.
Como confirmar: Aparece: "Script copiado para a área de transferência!"
Causa provável: O canal de origem não tem conversas para mover.
Como corrigir: - Selecione outro canal de origem.
- Se a intenção era trazer conversas antigas, selecione Conversas com canais removidos (quando fizer sentido).
Como confirmar: Aparece uma mensagem de sucesso com a quantidade de conversas transferidas (quando existir).
Tour rápido: o que cada parte faz
- Ações de conexão: Use Nova integração para conectar um novo canal.
Quando já existe pelo menos um canal, o botão também aparece no final da lista. - Horário de atendimento da IA: Selecione 24 Horas por dia ou defina dias e horários.
Quando não for 24h, aparece a mensagem Mensagem automática quando estivermos fora do horário e o botão Salvar Horário de Atendimento. - Status do canal: Cada canal mostra status como Ativo ou Desconectado.
Pode aparecer aviso de Sem resposta há ... (quando aplicável). - Botões por canal: Ações possíveis incluem:
- Reconectar
- Copiar Script (para Chat Widget)
- Transferir conversas (quando disponível)
- Desvincular ou Remover - Modal de QR Code do WhatsApp: Mostra passos para conectar e um QR code.
Se o QR ficar velho, pode aparecer o botão de recarregar (ícone de recarregar) para gerar outro.
O que muda quando configura
Alterações no sistema: Algumas opções mudam o comportamento do atendimento automaticamente:
- Horário de atendimento da IA controla quando a IA atende e quando a mensagem fora do horário pode ser exibida.
- Resolver conversa após pode resolver automaticamente (conforme as regras mostradas).
- Opções como Remover o atendente conectado, Remover o departamento vinculado e Limpar o histórico da conversa mudam o que acontece ao resolver uma conversa.
- Direcionar conversas para o departamento pode vincular novas conversas a um departamento.
- Distribuição dinâmica pode distribuir conversas automaticamente, dependendo do tipo escolhido.
- Whatsapp Qr-Code
- WhatsApp API Oficial
- Facebook Pages
- Chat Widget
Logs: Não há indicação de registros (logs) exibidos aqui. Confirme as mudanças observando o status (Ativo/Desconectado) e o comportamento nas conversas.