Integrações (canais de atendimento)

Conecte canais como WhatsApp, Instagram e Facebook, acompanhe status e ajuste quando a IA atende e como cada canal funciona.

codeCanais de atendimento
labelIntegrações
schoolintermediario
generated
schedule2026-10-01
notes

Para que serve

Permite conectar canais de atendimento da empresa (como WhatsApp, Instagram e Facebook) para captar conversas automaticamente e centralizar os atendimentos em um só lugar.

Também permite:
- Acompanhar Status dos canais (online/offline/total).
- Definir a Disponibilidade da IA.
- Ajustar configurações de cada canal (ex.: Modo de funcionamento, Base de conhecimento, Apelido e cor do canal).

notes

Resumo rápido

  • Clique em Nova integração (ou Conectar meu primeiro canal de atendimento).
  • Escolha um canal (ex.: WhatsApp QR Code, Instagram, WhatsApp API Oficial, Facebook Pages, Chat Widget).
  • Finalize a conexão (ex.: no WhatsApp, escaneie o QR Code).
  • Abra as configurações do canal para ajustar IA Ativa / IA Modo simulação / IA Desativada e a Base de conhecimento.
  • Ajuste a Disponibilidade da IA para definir quando a IA atende.
  • Clique em Salvar integrações para gravar as mudanças.

Resultado esperado: Os canais ficam conectados e aparecem com status (Ativo ou Desconectado) e as configurações ficam salvas.

format_list_numbered

Como conectar e configurar (passo a passo)

1

Iniciar uma nova conexão

Clique em Nova integração.

Se ainda não existe nenhum canal, clique em Conectar meu primeiro canal de atendimento.

2

Escolher o tipo de canal

No modal Novo canal de atendimento, escolha uma opção:
- WhatsApp QR Code (botão Gerar QR Code)
- Instagram (botão Conectar Instagram)
- WhatsApp API Oficial (botão Conectar com WhatsApp API)
- Facebook Pages (botão Conectar Facebook Pages)
- Chat Widget (botão Habilitar Widget)

3

Conectar WhatsApp por QR Code (quando escolhido)

No modal Conectar WhatsApp:
1. Aguarde o QR aparecer (texto Gerando QR Code...).
2. Siga as instruções No celular (WhatsApp > Dispositivos conectados > Conectar dispositivo).
3. Mantenha a janela aberta até concluir.

Se precisar, clique em Atualizar código ou Gerar novo QR Code.

4

Conferir o status do canal

Verifique o selo do canal:
- Ativo (online)
- Desconectado (offline)
- Alerta Sem resposta há ... (quando aparecer)

Quando existir, use o botão Reconectar (ou Gerar QR Code no WhatsApp QR Code).

5

Abrir as configurações do canal

Clique no canal para expandir.

Use o botão com o título Exibir configurações (ou Recolher configurações) para abrir/fechar os ajustes.

6

Ajustar a inteligência artificial do canal

Em Inteligência artificial:
- Selecione o Modo de funcionamento.
- Escolha a Base de conhecimento.
- Se necessário, defina Mensagem de saudação fixa (quando aparecer).

7

Ajustar identificação e aparência

Em Identificação e aparência:
- Preencha Apelido e cor do canal.
- Se for Chat Widget, ajuste Texto do Widget, Visual estilo WhatsApp e Imagem do Widget.

8

Salvar as alterações

Clique em Salvar integrações.

Se aparecer Processando, aguarde.

Ao final, confirme a mensagem Configurações salvas com sucesso.

edit_note

Campos principais

Horário de atendimento da IA

edit_noteseleção

Valor padrão: 24 horas por dia

Opcional

Descrição: Escolha quando a IA atende nos canais conectados.

Use:
- 24 horas por dia para deixar sempre disponível.
- Atender somente nos horários definidos para atender apenas nos períodos habilitados.
- Não atender nos horários definidos para pausar a IA nos períodos habilitados.

Regras/validações: Opções visíveis:
- 24 horas por dia
- Atender somente nos horários definidos
- Não atender nos horários definidos

Exemplos: - Exemplo 1: Selecionar Atender somente nos horários definidos.
- Exemplo 2: Selecionar Não atender nos horários definidos.

Resposta automática

edit_notetexto longo
Opcional

Descrição: Escreva a mensagem enviada quando o contato inicia conversa fora da disponibilidade configurada.

Dica: deixar em branco desativa essa mensagem.

Regras/validações: Placeholder visível: Mensagem exibida aos contatos fora do horário de atendimento.

Tooltip visível: Deixe este campo em branco para não enviar uma resposta automática fora do horário.

Exemplos: - Exemplo 1: "Agora estamos fora do horário. Retorno no próximo período."
- Exemplo 2: (em branco) para não enviar nada.

Modo de funcionamento

edit_noteseleção
Opcional

Descrição: Define como a IA age neste canal:
- IA Ativa: IA responde.
- IA Modo simulação: IA simula respostas.
- IA Desativada: IA fica desativada.

Regras/validações: Opções visíveis:
- IA Ativa
- IA Modo simulação
- IA Desativada

Exemplos: - Exemplo 1: Selecionar IA Ativa.
- Exemplo 2: Selecionar IA Desativada.

Base de conhecimento

edit_noteseleção
Opcional

Descrição: Escolha qual base a IA usa para responder neste canal.

Use os botões ao lado:
- Editar base de conhecimento (ícone de lápis)
- Criar base de conhecimento (ícone de +)

Regras/validações: Opção inicial visível: Selecione (desabilitada).

Exemplos: - Exemplo 1: Selecionar uma base pelo nome (lista).
- Exemplo 2: Clicar em Criar base de conhecimento para criar uma nova.

Mensagem de saudação fixa

edit_notetexto
Opcional

Descrição: Define um texto fixo exibido ao iniciar o chat.

Dica: deixar em branco desativa a saudação fixa.

Regras/validações: Placeholder visível: Texto exibido ao iniciar o chat.

Exemplos: - Exemplo 1: "Olá! Como posso ajudar?"
- Exemplo 2: (em branco) para não exibir saudação fixa.

Apelido e cor do canal

edit_notetexto + seleção de cor
Opcional

Descrição: Dê um nome fácil para reconhecer o canal e escolha uma cor para identificação.

Use o botão de paleta (Alterar cor do canal) para trocar a cor.

Regras/validações: Placeholder visível: Insira um apelido para este canal.

Exemplos: - Exemplo 1: Apelido: "WhatsApp Loja".
- Exemplo 2: Apelido: "Instagram Principal".

Tempo de resposta

edit_noteseleção
Opcional

Descrição: Define o ritmo da resposta.

Escolha uma das opções para deixar mais rápido ou mais natural.

Regras/validações: Opções visíveis:
- ⚡️ Ágil (~20 segundos)
- ⏱️ Equilibrado (~50 segundos)
- 🦌 Natural (~2 minutos)

Exemplos: - Exemplo 1: Selecionar ⏱️ Equilibrado (~50 segundos).
- Exemplo 2: Selecionar ⚡️ Ágil (~20 segundos).

Departamento das novas conversas

edit_noteseleção
Opcional

Descrição: Escolha para onde as novas conversas deste canal vão automaticamente.

Para não vincular, selecione Nenhum.

Regras/validações: Opção visível: Nenhum.

Alerta possível: A base do departamento substituirá a base definida no canal.

Exemplos: - Exemplo 1: Selecionar Nenhum.
- Exemplo 2: Selecionar um departamento pelo nome (lista).

Considerar conversa em atraso após

edit_notenúmero

Valor padrão: 30

Opcional

Descrição: Define após quanto tempo sem resposta a conversa aparece como "em atraso".

Regras/validações: Unidade exibida: minutos.

Campo com mínimo visível: min="1".

Exemplos: - Exemplo 1: 15 (minutos).
- Exemplo 2: 60 (minutos).

Resolver conversa após

edit_notenúmero

Valor padrão: 72

Opcional

Descrição: Define em quantas horas a conversa é resolvida automaticamente.

Use 0 para desativar.

Regras/validações: Unidade exibida: horas.

Tooltip visível: Use 0 para desativar. Esta regra é aplicada somente às conversas no modo IA Ativa.

Exemplos: - Exemplo 1: 0 (desativa).
- Exemplo 2: 24 (1 dia).

Contatos autorizados

edit_notecheckbox
Opcional

Descrição: Quando habilitado, a IA responde somente para contatos autorizados.

Use Configurar lista para ajustar quais contatos ficam autorizados.

Regras/validações: Texto visível: A IA responderá somente contatos previamente autorizados.

Botão visível quando habilitado: Configurar lista.

Exemplos: - Exemplo 1: Ativar para atender apenas uma lista de clientes.
- Exemplo 2: Desativar para atender qualquer contato.

Mensagem para contatos não autorizados

edit_notetexto longo
Opcional

Descrição: Escreva o que aparece para contatos que não estão autorizados, quando Contatos autorizados está ligado.

Regras/validações: Placeholder visível: Mensagem exibida para os contatos não autorizados.

Exemplos: - Exemplo 1: "Ops! No momento, você não está autorizado a conversar com este contato."
- Exemplo 2: "Atendimento disponível apenas para clientes cadastrados."

notes

Termos que aparecem e podem confundir

  • Status dos canais: Mostra um resumo com Online, Offline e Total de canais.

    Também permite abrir Disponibilidade da IA.
  • Disponibilidade da IA: Define quando a IA atende.

    Tooltip visível: Esta configuração é geral e será aplicada a todos os canais conectados.
  • Modo simulação: Aparece como IA Modo simulação e como selo Modo simulação.

    Indica que a IA está em modo de simulação, e não no modo normal IA Ativa.
  • Base de conhecimento: É a lista onde a IA busca informações para responder.

    Aparece com os botões Editar base de conhecimento e Criar base de conhecimento.
  • Contatos autorizados: Quando ativado, a IA responde somente para contatos permitidos.

    Aparece o botão Configurar lista.
notes

Regras e comportamentos importantes

  • Em Disponibilidade da IA, a configuração é geral e se aplica a todos os canais conectados.
  • Em Resposta automática, deixar o campo em branco significa não enviar mensagem fora do horário.
  • Nos horários por dia (campos de hora), quando o início passa do fim, o sistema ajusta para não ficar inválido (ex.: início e fim ficam iguais).
  • Em Considerar conversa em atraso após, o valor mínimo é 1 minuto.
  • Em Resolver conversa após, usar 0 desativa a regra.
  • Ao selecionar um Departamento das novas conversas, pode aparecer o aviso: A base do departamento substituirá a base definida no canal.
  • Em Contatos autorizados, a IA passa a responder somente quem estiver autorizado; use Configurar lista para ajustar.
notes

Receitas rápidas (casos comuns)

  • Conectar WhatsApp pelo QR Code: 1. Clique em Nova integração.
    2. Clique em Gerar QR Code em WhatsApp QR Code.
    3. No modal Conectar WhatsApp, siga No celular e escaneie o código.
    4. Aguarde o canal ficar Ativo.

    Resultado: WhatsApp conectado e pronto para configurar.
  • Definir horários em que a IA atende: 1. Clique em Disponibilidade da IA.
    2. Em Horário de atendimento da IA, selecione Atender somente nos horários definidos.
    3. Em Dias e horários, marque/desmarque os dias e ajuste os horários.
    4. (Opcional) Preencha Resposta automática.
    5. Clique em Salvar disponibilidade.

    Resultado: IA atende apenas nos períodos habilitados (ou fica pausada, se essa opção for escolhida).
  • Transferir conversas para um canal ativo: 1. Expanda um canal de WhatsApp que esteja Ativo.
    2. Clique em Transferir conversas.
    3. Selecione o canal de origem (ou Conversas com canais removidos).
    4. Conclua a transferência.

    Resultado: aparece uma mensagem como Nenhuma conversa encontrada para transferir ou uma confirmação com a quantidade de conversas.
bug_report

Problemas comuns e como resolver

errorAparece o modal: Não encontramos uma conta de WhatsApp para conectar

Causa provável: A conexão com a Meta foi concluída, mas nenhuma conta de WhatsApp Business foi liberada para a plataforma.

Como corrigir: Leia o bloco Causas mais prováveis: e refaça a conexão.

Clique em Tentar conectar novamente e, na etapa da Meta:
- Selecione o negócio correto.
- Selecione a conta de WhatsApp correta.
- Selecione o número que deseja conectar.
- Aceite as permissões relacionadas ao WhatsApp Business.

Como confirmar: Ao concluir, o modal não aparece mais e o canal passa a ficar disponível para conectar.

errorNo modal Conectar WhatsApp, fica em Gerando QR Code... e não carrega

Causa provável: O QR Code pode estar demorando ou o código pode ter expirado.

Como corrigir: Clique em Atualizar código.

Se continuar, clique em Gerar novo QR Code.

Como confirmar: O QR Code aparece e o status mostra Aguardando leitura pelo WhatsApp.

errorAparece o selo Sem resposta há ... no canal

Causa provável: O canal pode ter parado de responder e precisa ser reconectado.

Como corrigir: Clique em Reconectar.

Se o botão mostrar Gerar QR Code, escaneie novamente no WhatsApp.

Como confirmar: O selo volta para Ativo (quando a conexão normaliza).

errorAo salvar, aparece: Revise os campos destacados da integração: ...

Causa provável: Algum campo do canal ficou com valor inválido (o sistema destaca o que precisa ajustar).

Como corrigir: Volte ao canal indicado na mensagem.

Corrija os campos destacados e clique em Salvar integrações novamente.

Como confirmar: Aparece a confirmação Configurações salvas com sucesso.

errorAo copiar, aparece Falha ao copiar o script.

Causa provável: O navegador pode ter bloqueado a cópia para a área de transferência.

Como corrigir: Tente novamente usando Copiar Script.

Se existir alguma restrição do navegador, permita a cópia e repita a ação.

Como confirmar: Aparece Script copiado para a área de transferência!

notes

O que muda no funcionamento

Alterações no sistema: Ao mudar a Disponibilidade da IA, a regra vale para todos os canais conectados.

Ao ativar Contatos autorizados, a IA passa a responder somente para contatos autorizados e pode enviar uma Mensagem para contatos não autorizados.

Configurações como Tempo de resposta, Resolver conversa após e Considerar conversa em atraso após mudam como as conversas são conduzidas e priorizadas.

  • WhatsApp QR Code
  • Instagram
  • WhatsApp API Oficial
  • Facebook Pages
  • Chat Widget

Logs: As confirmações e problemas aparecem como mensagens na própria experiência, por exemplo:
- Configurações salvas com sucesso
- Erro ao gerar QR Code! Tente novamente mais tarde
- Erro ao transferir conversas