OmnichannelCentral de conhecimento
DOCUMENTAÇÃO COMPLETA

Seu manual do Omnichannel

203 guias · Revisão 14/10/2026

Use a impressão do navegador e escolha “Salvar como PDF” para levar o manual com você.

Índice de todos os guias
  1. Configure sua operação pela primeira vez
  2. Entrar, trocar a senha inicial e sair
  3. Ativar dois fatores e guardar a recuperação
  4. Alterar ou recuperar sua senha
  5. Escolher o idioma da interface
  6. Entender o menu, as filas e seus acessos
  7. Assumir um atendimento da fila
  8. Buscar atendimentos e interpretar os cartões
  9. Enviar texto, responder uma mensagem e usar IA
  10. Registrar notas e observações internas
  11. Enviar fotos, vídeos e documentos
  12. Gravar, ouvir e enviar áudio
  13. Salvar e utilizar figurinhas
  14. Usar respostas rápidas e variáveis
  15. Enviar HSM e retomar contato no WhatsApp
  16. Transferir e inserir outro atendente
  17. Adicionar etiquetas e motivo do atendimento
  18. Encerrar um atendimento e acompanhar a pesquisa
  19. Consultar encerrados e a linha do tempo
  20. Abrir um chamado e iniciar um novo WhatsApp
  21. Abrir notificações e conferir alertas
  22. Entender reações nas mensagens
  23. Identificar anúncios e distinguir os prazos do WhatsApp
  24. Agendar uma conversa e retomar o atendimento
  25. Ver quem está visualizando ou digitando na conversa
  26. Criar e executar ações rápidas no atendimento
  27. Localizar clientes e consultar seus atendimentos
  28. Localizar, vincular e desvincular o assinante IXC
  29. Consultar contratos, conexão e serviços do IXC
  30. Enviar segunda via e Pix pelo atendimento
  31. Consultar e enviar nota fiscal
  32. Solicitar desbloqueio de confiança
  33. Consultar chamados e criar uma ordem de serviço
  34. Conferir imagens e comprovantes recebidos
  35. Preparar um modelo de cobrança com Pix e PDF
  36. Conferir comprovante Pix pelo IXC
  37. Trocar o telefone e impedir cobranças para o número antigo
  38. Conectar e ativar o WhatsApp
  39. Conectar uma API oficial do WhatsApp pelos dados da conta
  40. Criar, revisar e excluir modelos WhatsApp
  41. Atualizar perfil e consultar registros do WhatsApp
  42. Conectar Instagram Direct
  43. Conectar Facebook Messenger
  44. Conectar e administrar um bot Telegram
  45. Instalar o chat no site ou WordPress
  46. Usar o chat do site como cliente
  47. Receber o resultado do teste de velocidade no chat
  48. Escolher o fluxo de entrada de um canal
  49. Desconectar e reconectar um canal social
  50. Encontrar e gerenciar integrações no catálogo
  51. Gerenciar vários números do WhatsApp
  52. Distinguir menções e respostas a stories
  53. Filtrar modelos WhatsApp por formato
  54. Publicar uma central de ajuda para os clientes
  55. Entender conteúdo não disponibilizado pelo WhatsApp
  56. Configurar provedores de inteligência artificial
  57. Configurar transcrição e interpretação de imagens
  58. Criar e configurar um agente virtual
  59. Cadastrar intenções e ações autorizadas
  60. Revisar aprendizado e exemplos históricos
  61. Cadastrar conhecimento e procedimentos
  62. OpenAI: criar a chave, conectar e acompanhar o consumo
  63. Gemini: criar a chave e conectar o Google AI Studio
  64. Claude: criar a chave Anthropic e acompanhar o consumo
  65. Criar um fluxo no construtor visual
  66. Criar um fluxo do zero: exemplo com imagens
  67. Testar, publicar e desfazer uma versão do fluxo
  68. Importar, revisar e excluir fluxos
  69. Usar variáveis e condições no fluxo
  70. Entender quais blocos executam ações
  71. Bloco: Início
  72. Bloco: Enviar mensagem
  73. Bloco: Enviar pergunta
  74. Bloco: Solicitar descrição do atendimento
  75. Bloco: Enviar pesquisa de satisfação
  76. Bloco: Opt-in/opt-out (WhatsApp)
  77. Bloco: Condicional
  78. Bloco: Identificar intenção
  79. Bloco: Conversar com agente de IA
  80. Bloco: Adicionar etiqueta
  81. Bloco: Autenticação simples
  82. Bloco: Auto vincular contato
  83. Bloco: Identificar no IXC
  84. Bloco: Consultar financeiro
  85. Bloco: Consultar nota fiscal
  86. Bloco: Consultar contrato
  87. Bloco: Desbloquear contrato
  88. Bloco: Integração ERP / IXC
  89. Bloco: Criar delay
  90. Bloco: Transferir atendimento
  91. Bloco: Executar fluxo
  92. Bloco: Enviar notificação
  93. Bloco: Fim do fluxo automático
  94. Bloco: Abrir atendimento pelo WhatsApp
  95. Bloco: Conta
  96. Bloco: Desviar ligação
  97. Bloco: Marcar horário na agenda
  98. Bloco: Requisição HTTP
  99. Bloco: Template interativo
  100. Bloco: Enviar arquivo
  101. Fluxo sem IA: menu 1 Suporte, 2 Comercial, 3 Financeiro
  102. Ativar um fluxo publicado sem abrir o editor
  103. Criar e revisar uma campanha de WhatsApp
  104. Iniciar, agendar ou cancelar uma campanha
  105. Acompanhar resultados e repetir uma falha elegível
  106. Registrar consentimento e respeitar descadastro
  107. Criar usuário e entregar o primeiro acesso
  108. Editar, inativar e redefinir acesso de usuários
  109. Criar e ajustar perfis de permissão
  110. Criar departamentos e definir SLA
  111. Configurar o horário geral de atendimento humano
  112. Cadastrar feriados e expediente especial
  113. Configurar Empresa por abas
  114. Definir o encerramento do login por inatividade
  115. Exigir autenticação em dois fatores da equipe
  116. Cadastrar e manter etiquetas
  117. Cadastrar motivos do atendimento
  118. Cadastrar motivos de pausa
  119. Cadastrar e manter mensagens rápidas
  120. Definir o que acontece quando o cliente não responde
  121. Configurar a sequência e o prazo da pesquisa
  122. Editar departamentos e entender os bloqueios de exclusão
  123. Configurar a capacidade dos atendentes
  124. Consultar indicadores e desempenho da equipe
  125. Tratar avaliações baixas e registrar retorno
  126. Revisar alertas de qualidade do atendimento
  127. Gerenciar oportunidades no funil comercial
  128. Registrar e acompanhar tarefas internas
  129. Usar o discador e configurar a telefonia
  130. Consultar mensagens e custos aproximados do WhatsApp
  131. Entender a franquia e os custos do WhatsApp
  132. Consultar o histórico de envios de cobrança IXC
  133. Links externos para configurar suas integrações
  134. Configurar e revisar a integração IXC
  135. Preparar a ponte de integração do IXC
  136. Configurar a integração SGP
  137. Configurar um conector HTTP
  138. Cadastrar webhooks de integração
  139. Configurar SMTP e enviar o teste de conexão
  140. Configurar SFTP para receber backups
  141. Conectar Google Drive para backups
  142. Agendar backups automáticos
  143. Consultar cópias locais e do Google Drive
  144. Definir quantas cópias de backup manter
  145. Solicitar e conferir uma restauração de backup
  146. Consultar licença e módulos disponíveis
  147. Consultar e solicitar atualizações da instalação
  148. Consultar e baixar erros das integrações
  149. Preparar a integração com um PABX externo
  150. Distinguir matriz, cliente e versão publicada
  151. Acessar a gerência e administrar seus usuários
  152. Gerenciar planos, renovações e recursos por cliente
  153. Preparar uma nova instalação pela gerência
  154. Conferir e publicar uma versão comercial preparada
  155. Gerar a chave FSNET IA de uma empresa
  156. Conferir franquia e consumo da FSNET IA
  157. Registrar uma solicitação de privacidade
  158. Conferir alcance e exportar o histórico de um titular
  159. Registrar retenção de dados e simular alcance
  160. Revisar fornecedores e compartilhamentos
  161. Registrar e acompanhar um incidente
  162. Manter o inventário de dados
  163. Conferir indicadores de privacidade e segurança
  164. Entender a segurança das sessões do chat do site
  165. Usar o Omnichannel no celular
  166. Atender e executar ações no aplicativo
  167. Conferir limitações e notificações do aplicativo
  168. Resolver mensagens que não chegam ou não saem
  169. Resolver falhas de integração e configuração
  170. Preparar um chamado de suporte útil
  171. Pedir ajuda e acompanhar uma solicitação
  172. Entender os termos usados no Omnichannel
  173. Consultar cobertura e disponibilidade da wiki
  174. Novidades do Omnichannel e disponibilidade por versão
  175. Salvar o login no aplicativo e aguardar novas tentativas
  176. Conferir notificações e push no Android
  177. Encontrar orientações na central de ajuda
  178. Meta: escolher a configuração e seguir o roteiro
  179. Meta Business: preparar portfólio e acessos
  180. Meta for Developers: preparar o aplicativo próprio
  181. WhatsApp Manager: localizar WABA e número
  182. Meta Business: gerar token e atribuir a WABA correta
  183. WhatsApp: cadastrar, verificar e ativar o número
  184. Cadastro integrado: autorizar o WhatsApp pela Meta
  185. Meta Developers: configurar o webhook do WhatsApp
  186. WhatsApp Manager: criar e acompanhar modelos
  187. Instagram: preparar conta profissional e acesso
  188. Instagram: cadastrar callback e assinar mensagens
  189. Facebook: configurar Página e token do Messenger
  190. Messenger: cadastrar webhook e eventos da Página
  191. Meta: revisão do aplicativo e liberação para clientes
  192. WhatsApp: migrar de fornecedor e avaliar coexistência
  193. Meta: renovar credenciais e resolver permissões
  194. IXC: entender as duas integrações e seus tokens
  195. IXC: criar usuário de API e obter o token
  196. IXC: configurar grupo e permissões por recurso
  197. IXC: liberar rede e conferir o endereço da API
  198. IXC: cadastrar a ponte em Integrações Omnichannel
  199. IXC: homologar a ponte com destinatário restrito
  200. IXC: liberar produção e definir a integração padrão
  201. IXC: preparar modelos e rotinas de cobrança
  202. IXC: preparar cadastros para consultas e abertura de OS
  203. IXC: validar boleto, Pix, nota fiscal e desbloqueio
Primeiros passos

Configure sua operação pela primeira vez

Uma sequência para preparar a empresa, liberar a equipe e iniciar os atendimentos.

Onde encontrarConfigurações; Minha conta; Integrações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Entre com o administrador recebido na instalação e conclua a troca da senha temporária.
  2. Em Minha conta, configure os dois fatores e guarde os códigos de recuperação.
  3. Em Configurações → Empresa, percorra Cadastro, Atendimento, Pesquisa e Sessões; confira também Distribuição quando estiver disponível pela licença.
  4. Cadastre os departamentos com seus prazos de primeira resposta e resolução. Defina o horário geral de atendimento e os feriados.
  5. Crie perfis de permissão e usuários, vinculando os atendentes aos setores que devem atender.
  6. Abra Integrações e conecte os canais contratados. Configure IXC ou SGP se fizerem parte da operação.
  7. Revise os fluxos, valide a estrutura, publique a versão e selecione o fluxo de entrada de cada canal.
  8. Se houver IA contratada, configure o provedor e o agente com conhecimento e ferramentas autorizadas.
  9. Faça o primeiro atendimento com um contato da própria equipe autorizado para homologação. Confira fila, resposta, transferência e encerramento.

Resultado esperado

Empresa, equipe, canais e roteamento preparados para iniciar a operação com os recursos habilitados.

Observações importantes

  • Uma conta de administrador sem setor pode administrar a empresa, mas não recebe distribuição automática.
  • Conectar um canal e publicar um fluxo são tarefas distintas: confira as duas.
  • A wiki é um manual de uso; não executa operações no Omnichannel.

Se precisar de ajuda

  • Se uma tela não aparece, confira perfil, licença e versão instalada.
  • Se o canal está conectado mas a conversa não chega, siga o diagnóstico de canais.
Primeiros passos

Entrar, trocar a senha inicial e sair

Acesse o painel com sua conta e conclua as etapas de segurança solicitadas.

Onde encontrarEndereço do painel fornecido pela sua empresa

Antes de começar

  • Tenha o endereço do painel e uma conta criada pelo administrador.

Passo a passo

  1. Abra o endereço HTTPS do Omnichannel.
  2. Informe seu e-mail e sua senha.
  3. Se solicitado, informe o código do autenticador ou um código de recuperação ainda não utilizado.
  4. Ao receber uma senha temporária, defina uma nova senha no formulário obrigatório antes de abrir os atendimentos.
  5. Se a empresa exigir dois fatores, conclua a configuração do aplicativo autenticador.
  6. Ao terminar seu expediente, use Sair no menu da conta.

Resultado esperado

O menu e os atendimentos permitidos para sua conta ficam disponíveis após concluir a autenticação.

Observações importantes

  • Sair encerra a sessão. A inatividade também pode encerrar o login conforme a política da empresa.
  • A opção de confiar no dispositivo é adequada apenas a um equipamento sob seu controle.

Se precisar de ajuda

  • Senha esquecida: solicite ao administrador a redefinição em Administração → Usuários.
  • Código recusado: confira data e hora automáticas do celular e use o código atual.
  • Acesso bloqueado: peça revisão do status da conta e do limite de sessões.
Primeiros passos

Ativar dois fatores e guardar a recuperação

Proteja a conta com um aplicativo autenticador e revise dispositivos autorizados.

Onde encontrarMinha conta → Segurança da conta

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Autenticação em dois fatores e inicie a ativação.
  2. No seu aplicativo autenticador, adicione uma conta lendo o QR Code. Se necessário, use Copiar chave.
  3. Informe o código de seis dígitos gerado pelo aplicativo e confirme.
  4. Copie os códigos de recuperação para um local protegido. Cada código serve apenas uma vez.
  5. Confirme Concluí, salvei os códigos.
  6. Consulte Dispositivos autorizados. Revogue individualmente um navegador que não utiliza mais.
  7. Para desconectar todas as sessões e dispositivos, use Revogar todos e confirme a senha e o código exigidos.

Resultado esperado

O login passa a exigir o segundo fator conforme a política e a confiança concedida aos dispositivos.

Observações importantes

  • Os códigos de recuperação não serão exibidos novamente.
  • A confiança de um navegador tem prazo de 30 dias. Revogar um dispositivo e revogar todas as sessões são ações diferentes.
  • Desativar 2FA pede senha e código e pode ser impedido pela política da empresa.
  • Nas versões a partir de 0.45.6, novos QR Codes usam o nome cadastrado da empresa e preservam o e-mail da conta. Entradas já cadastradas no autenticador não mudam de nome automaticamente; não é necessário desativar o 2FA por esse motivo.

Se precisar de ajuda

  • Se perdeu autenticador e códigos, solicite recuperação ao administrador; não crie outra conta para contornar a política.
  • Um QR ilegível pode ser cadastrado pela chave manual.
Primeiros passos

Alterar ou recuperar sua senha

Atualize sua senha pessoal ou receba uma nova senha temporária do administrador.

Onde encontrarMinha conta → Alterar senha; Administração → Usuários

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Minha conta → Alterar senha.
  2. Informe a senha atual, a nova senha e a confirmação solicitada.
  3. Se os dois fatores estiverem habilitados, informe também um código válido do autenticador.
  4. Salve e aguarde a confirmação antes de sair da tela.
  5. Se perdeu acesso, solicite ao administrador a redefinição para uma senha temporária, entregue por meio reservado.
  6. Entre com a senha temporária e conclua a troca obrigatória antes de voltar aos atendimentos.

Resultado esperado

A senha nova passa a ser utilizada nos próximos acessos; a redefinição temporária exige uma nova senha pessoal.

Observações importantes

  • Contas já estabelecidas exigem senha atual e autenticador quando habilitado. O primeiro acesso com senha temporária mantém seu fluxo próprio.
  • Uma troca válida revoga as outras sessões; a sessão atual é preservada quando identificada pelo servidor.
  • A senha temporária aparece uma única vez ao administrador. Não há recuperação autônoma por e-mail documentada nessa tela.
  • No app com login salvo, apague ou atualize a credencial antiga após a troca. Salvar senha não remove a exigência de segundo fator.

Se precisar de ajuda

  • Se não aparecer confirmação de salvamento, confira o erro do formulário antes de tentar novamente.
  • Confirme o e-mail e o domínio corretos ao receber uma senha temporária.
Primeiros passos

Escolher o idioma da interface

Altere a preferência de idioma no navegador que você utiliza.

Onde encontrarMinha conta → Configurações da conta

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Minha conta.
  2. Em Configurações da conta, localize o seletor de idioma.
  3. Selecione um idioma disponibilizado pelo painel.
  4. Volte à tela de atendimentos e confira os textos da interface.

Resultado esperado

A interface adota a preferência salva neste navegador.

Observações importantes

  • A escolha não traduz mensagens dos clientes nem altera a preferência dos outros usuários.
  • Administradores também encontram a opção em Administração → Empresa.

Se precisar de ajuda

  • Em outro navegador ou após limpar dados do site, selecione o idioma novamente.
Primeiros passos

Entender o menu, as filas e seus acessos

Saiba onde acompanhar fila, andamento, automação, histórico e administração.

Onde encontrarMenu lateral do painel
Atendimentos

Assumir um atendimento da fila

Passe a ser responsável por uma conversa e dê continuidade com o histórico disponível.

Onde encontrarFila → conversa → Assumir atendimento

Antes de começar

  • Tenha permissão para assumir conversas e acesso ao setor.

Passo a passo

  1. Abra Fila e selecione a conversa pelo nome, canal e protocolo.
  2. Leia o histórico, o motivo e os dados já coletados pelo robô.
  3. Clique em Assumir atendimento. Se a tela solicitar o setor, selecione um departamento em que você esteja autorizado a atuar.
  4. Aguarde a confirmação e confira seu nome no responsável.
  5. Envie uma resposta adequada ao que o cliente já explicou.
  6. Acompanhe a conversa em Andamento → Meus atendimentos.

Resultado esperado

O atendimento passa a estar atribuído a você, quando a operação é aceita pelo servidor.

Observações importantes

  • O acesso depende de permissão para atribuir e do departamento.
  • A distribuição automática também considera usuários online e as regras de horário.
  • Confira se outro atendente assumiu a conversa antes de enviar.
  • Nas versões comerciais a partir de 1.0.35, o administrador pode assumir um atendimento de qualquer setor ativo mesmo fora do horário. Essa exceção não libera a distribuição automática ou a atribuição a outros atendentes fora do expediente.

Se precisar de ajuda

  • Se o botão estiver indisponível, confira responsável, setor e permissões.
  • Se o atendimento sumiu da fila, procure em Andamento e consulte o responsável atual.
Atendimentos

Buscar atendimentos e interpretar os cartões

Localize uma conversa e confira canal, protocolo, responsável e tempo de espera.

Onde encontrarFila / Andamento / Agentes virtuais / Encerrados

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Selecione primeiro a etapa em que espera encontrar a conversa.
  2. Em Andamento ou Encerrados, escolha Meus atendimentos, Meus departamentos ou Todos.
  3. Digite nome, telefone ou protocolo no campo de busca disponível.
  4. Abra o resultado e confira o protocolo para diferenciar conversas do mesmo contato.
  5. Confira canal, setor, responsável e horário no cartão e no contexto do cliente.
  6. Em listas paginadas ou histórico com carregamento adicional, avance para consultar registros anteriores.

Resultado esperado

O atendimento correto é aberto dentro do escopo autorizado.

Observações importantes

  • O horário do atendimento e o horário da última mensagem têm finalidades diferentes.
  • Mensagem não visualizada, tempo sem resposta e status de envio também são indicadores distintos.
  • Em Meus atendimentos, o cartão destacado indica mensagem ainda não lida pelo responsável. A visualização por outro usuário não limpa essa pendência.

Se precisar de ajuda

  • Busca sem resultado: limpe filtros e procure em Encerrados ou Todos.
  • Não conclua que o histórico foi apagado apenas porque não apareceu na fila atual.
Atendimentos

Enviar texto, responder uma mensagem e usar IA

Converse com o cliente usando o editor e revise sugestões antes do envio.

Onde encontrarAtendimento aberto → editor de mensagem

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confirme o contato e o protocolo selecionados.
  2. Verifique que o editor está em modo de resposta ao cliente.
  3. Digite a mensagem. Para citar um trecho específico, use Responder na mensagem e confira a referência exibida sobre o editor.
  4. Se houver sugestão de IA disponível, solicite a sugestão e revise nomes, valores e o procedimento antes de utilizá-la.
  5. Envie uma única vez e acompanhe o status na conversa.
  6. Se o envio ficar sem confirmação, confira o histórico e o aviso antes de repetir.

Resultado esperado

A resposta aparece na conversa com a identificação do remetente e a situação de envio.

Observações importantes

  • Uma sugestão de IA não comprova pagamentos nem autoriza alterações contratuais.
  • No WhatsApp, janela expirada exige HSM aprovado e resposta do cliente antes de mensagens livres.
  • Notas internas não chegam ao cliente.

Se precisar de ajuda

  • Se o envio falhar, verifique a mensagem de erro, a conexão do canal e a janela de atendimento.
  • Em confirmação incerta, evite duplicar o envio.
Atendimentos

Registrar notas e observações internas

Deixe contexto para a equipe sem enviar o texto ao cliente.

Onde encontrarConversa → nota interna; painel do cliente → Observação do atendimento

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a conversa correta e selecione o modo de nota interna no editor.
  2. Confira a indicação visual do modo interno.
  3. Registre informações objetivas: o que foi conferido, o que falta e quem dará continuidade.
  4. Salve a nota e confira seu registro no histórico.
  5. Para a observação lateral, edite Observação do atendimento e use o comando de salvar disponível.
  6. Ao voltar a falar com o cliente, retorne explicitamente ao modo de resposta.

Resultado esperado

A equipe encontra o contexto interno do atendimento.

Observações importantes

  • Evite registrar senhas ou cópias desnecessárias de documentos.
  • Notas e observações têm controles próprios; editar a observação não equivale a editar uma mensagem enviada.

Se precisar de ajuda

  • Se não aparecer no histórico ou no painel após salvar, confira o aviso e recarregue a conversa.
  • Sempre confira o modo do editor antes de enviar.
Atendimentos

Enviar fotos, vídeos e documentos

Selecione um arquivo, revise a prévia e acompanhe o envio pelo canal.

Onde encontrarConversa → Anexo / Foto / Vídeo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a conversa e confira se o canal permite o envio.
  2. No menu de mídia, escolha o tipo de arquivo.
  3. Selecione o arquivo do computador ou celular.
  4. Confira a prévia, o nome e a legenda, quando disponível. Remova a seleção se não for o arquivo correto.
  5. Envie e espere o resultado antes de escolher outro anexo.
  6. Abra a mídia no histórico para conferir a identificação do envio.

Resultado esperado

A mídia aparece no atendimento e segue o processamento do canal.

Observações importantes

  • Os limites e formatos aceitos são validados pelo sistema e pelo canal. A API documentada utiliza imagens JPEG/PNG até 5 MB e demais mídias suportadas até 16 MB.
  • Não envie documentos de outro cliente por engano.
  • O recebimento de um anexo não significa que uma IA o interpretou corretamente.

Se precisar de ajuda

  • Arquivo recusado: confira formato e tamanho indicados no erro.
  • Falha após enviar: consulte o status antes de repetir, especialmente em conexão instável.
Atendimentos

Gravar, ouvir e enviar áudio

Use o microfone com revisão antes de enviar a gravação.

Onde encontrarConversa → controle de áudio

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra o atendimento e autorize o microfone quando o navegador solicitar.
  2. Inicie a gravação e acompanhe o contador.
  3. Use Parar para concluir ou Cancelar para descartar.
  4. Ouça a prévia, se o navegador oferecer reprodução do formato.
  5. Envie somente após conferir o conteúdo.
  6. No histórico, abra áudios recebidos para ouvir o original; consulte a transcrição quando habilitada.

Resultado esperado

O áudio é enviado como mídia na conversa.

Observações importantes

  • Gravar exige navegador com suporte e acesso seguro HTTPS.
  • Uma transcrição pode conter erros: mantenha o original como referência.
  • A transcrição depende da configuração e disponibilidade do provedor.
  • Se a transcrição estiver ausente ou incorreta, consulte o áudio original. O provedor de transcrição é configurado separadamente da IA que responde em texto.

Se precisar de ajuda

  • Microfone bloqueado: libere a permissão nas configurações do site no navegador.
  • Sem pré-escuta: use um navegador compatível ou envie um arquivo de áudio suportado.
Atendimentos

Salvar e utilizar figurinhas

Reaproveite figurinhas recebidas e organize a biblioteca da empresa.

Onde encontrarConversa → Salvar figurinha / Figurinhas; Administração → Figurinhas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Em uma figurinha recebida, use Salvar figurinha.
  2. No editor de uma conversa, abra o menu de mídia e selecione Figurinhas.
  3. Escolha um item da biblioteca e confira a prévia.
  4. Confirme o envio para o atendimento selecionado.
  5. Como administrador, abra Administração → Figurinhas para revisar os itens e os comandos de manutenção apresentados.

Resultado esperado

A figurinha salva fica disponível na biblioteca e pode ser utilizada nos canais compatíveis.

Observações importantes

  • O suporte depende do canal e do formato.
  • A biblioteca vazia não impede enviar fotos ou documentos.

Se precisar de ajuda

  • Se nenhum item aparecer, salve uma figurinha recebida e atualize a biblioteca.
  • Se o envio for recusado, confira a compatibilidade do canal.
Atendimentos

Usar respostas rápidas e variáveis

Aplique textos padronizados e personalize a resposta para o cliente.

Onde encontrarConversa → Resposta rápida

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Resposta rápida no editor.
  2. Selecione uma resposta disponível ao seu setor.
  3. Confira o texto inserido e as variáveis substituídas.
  4. Ajuste o conteúdo para a dúvida atual, sem apagar informações importantes.
  5. Envie e acompanhe o status.

Resultado esperado

Uma mensagem padronizada é usada com revisão humana.

Observações importantes

  • As respostas disponíveis respeitam os departamentos autorizados.
  • Uma resposta rápida comum não substitui um modelo HSM aprovado quando a janela WhatsApp estiver fechada.

Se precisar de ajuda

  • Resposta ausente: peça ao administrador para conferir se está cadastrada e liberada para seu setor.
  • Variável sem valor: revise os dados e o texto antes de enviar.
Atendimentos

Enviar HSM e retomar contato no WhatsApp

Use um modelo aprovado quando o painel indicar que a janela de atendimento expirou.

Onde encontrarConversa WhatsApp → Enviar HSM

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra o atendimento e clique em Enviar HSM.
  2. Selecione um modelo aprovado disponível para o setor.
  3. Preencha as variáveis de cabeçalho e mensagem solicitadas. Se houver mídia, informe o link público HTTPS do arquivo correto.
  4. Preencha complementos de botões quando solicitados.
  5. Confira a prévia e clique em Enviar HSM.
  6. Aguarde a confirmação de envio e, para voltar às mensagens livres, a resposta do cliente.

Resultado esperado

O template é colocado na fila de envio. A resposta do cliente permite continuar o atendimento conforme a janela indicada pelo sistema.

Observações importantes

  • Enviar ou entregar o HSM, sozinho, não equivale à resposta do cliente.
  • Modelos com componentes não suportados são bloqueados neste diálogo.
  • A aprovação e a disponibilidade do modelo dependem da Meta e das permissões do setor.
  • Na abertura de chamado, modelos aprovados de outro setor podem aparecer identificados como restritos. A aprovação na Meta não libera o uso em todos os departamentos. Use Atualizar modelos, quando disponível, para consultar novas aprovações sem fechar o formulário.

Se precisar de ajuda

  • Lista vazia: confira modelos aprovados e departamentos permitidos na integração WhatsApp.
  • Campo obrigatório: preencha todas as variáveis, inclusive cabeçalho e botão.
  • Modelo recusado: selecione outro formato suportado e consulte o administrador.
Atendimentos

Transferir e inserir outro atendente

Encaminhe a conversa com contexto ou adicione um participante autorizado.

Onde encontrarCabeçalho da conversa → Transferir para… / Inserir atendente…

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Leia o motivo e registre uma nota interna com o que foi realizado.
  2. Em Transferir para…, selecione o setor ou destino permitido pela interface.
  3. Selecione o atendente quando essa opção for oferecida e confirme a ação.
  4. Confira o setor e o responsável após a transferência.
  5. Para incluir ajuda sem trocar o encaminhamento, use Inserir atendente… e escolha um usuário disponível na lista.
  6. Consulte Acompanhando para conferir os participantes.

Resultado esperado

A conversa mantém o histórico e passa ao destino ou recebe o participante selecionado, conforme a ação utilizada.

Observações importantes

  • Inserir participante e transferir são operações diferentes.
  • O horário humano e a disponibilidade da equipe podem manter a conversa na fila de destino.
  • A transferência não deve ser usada como encerramento.

Se precisar de ajuda

  • Destino ausente: confira permissões, departamento e usuários ativos.
  • Sem atendente online: acompanhe a fila em vez de repetir transferências.
Atendimentos

Adicionar etiquetas e motivo do atendimento

Organize o atendimento para busca, continuidade e análise da operação.

Onde encontrarConversa → Motivo do atendimento; Contexto do cliente → Etiquetas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a conversa e selecione o motivo que melhor descreve a solicitação.
  2. No contexto do cliente, abra Etiquetas do atendimento.
  3. Escolha uma etiqueta cadastrada e use o comando de adicionar.
  4. Remova uma etiqueta incorreta pelo controle do item.
  5. Confira as informações salvas antes de transferir ou encerrar.

Resultado esperado

O atendimento fica classificado por motivo e etiquetas.

Observações importantes

  • Intenções identificadas pelo fluxo e etiquetas manuais são informações diferentes.
  • Novas intenções podem ser acrescentadas ao histórico sem apagar as anteriores.

Se precisar de ajuda

  • Etiqueta ou motivo ausente: solicite cadastro ao administrador.
  • Se houver erro de atualização, confira o estado da conversa antes de repetir.
Atendimentos

Encerrar um atendimento e acompanhar a pesquisa

Finalize o atendimento após revisar a solução e o motivo registrado.

Onde encontrarConversa → Encerrar

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confirme que a solicitação foi tratada ou encaminhada conforme o procedimento da empresa.
  2. Registre a orientação final, o motivo e as notas internas necessárias.
  3. Use Encerrar e conclua a confirmação apresentada, quando houver.
  4. Confira o atendimento em Encerrados.
  5. Se a pesquisa estiver habilitada, acompanhe a sequência automática configurada pela empresa.
  6. Para contatar novamente pelo WhatsApp, abra um novo chamado com HSM quando o painel oferecer essa opção.

Resultado esperado

O protocolo fica encerrado e a pesquisa segue a política da empresa.

Observações importantes

  • Fim do fluxo automático encerra a automação; não tem o mesmo efeito do botão Encerrar.
  • A pesquisa tem prazo próprio e pode terminar sem nota.
  • Evite encerrar apenas para retirar uma conversa da fila.
  • Uma avaliação enviada depois do prazo pode ser vinculada ao encerrado sem criar nova conversa. Se houver um pedido novo de ajuda, ele segue o atendimento normal.

Se precisar de ajuda

  • Atendimento não mudou de estado: confira a confirmação e eventuais erros.
  • Pesquisa não enviada: confira a configuração da empresa e as condições do canal.
Atendimentos

Consultar encerrados e a linha do tempo

Leia conversas antigas, eventos e histórico importado sem alterar o protocolo.

Onde encontrarEncerrados; conversa → Linha do tempo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Encerrados e escolha Meus atendimentos, Meus departamentos ou Todos, conforme o acesso da sua conta.
  2. Use busca, filtros e paginação para localizar o protocolo.
  3. Na conversa, confira os separadores de dia e as datas das mensagens, além do horário.
  4. Se lembretes idênticos consecutivos do IXC estiverem agrupados, confira a data, o horário e o status de cada envio.
  5. Use a opção de expandir para ler os envios originais e suas referências.
  6. Abra Linha do tempo para consultar atribuição, transferência e encerramento. Observe a indicação de origem quando houver histórico importado.
  7. Quando precisar continuar o contato em outro protocolo, use o procedimento de novo chamado oferecido pelo painel.

Resultado esperado

O histórico autorizado fica disponível para consulta.

Observações importantes

  • Agrupar mensagens muda sua apresentação; não apaga registros nem impede que lembretes tenham sido enviados em dias diferentes.
  • O agrupamento preserva as mensagens originais, suas respostas e reações. Nem toda mensagem parecida será agrupada.
  • Filtrar ou ler um atendimento encerrado não o reabre nem muda seu responsável.
  • Registros importados sem atendente não são atribuídos artificialmente ao usuário atual.

Se precisar de ajuda

  • Procure em Todos se o responsável do registro antigo for desconhecido.
  • Mídias antigas podem depender da disponibilidade da origem.
Atendimentos

Abrir um chamado e iniciar um novo WhatsApp

Registre uma solicitação recebida por outro meio ou inicie um novo protocolo para um contato existente.

Onde encontrarMenu → Abertura de chamado; Encerrados → Novo chamado pelo WhatsApp

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Abertura de chamado.
  2. Busque um cliente cadastrado ou preencha nome e telefone com DDD.
  3. Escolha canal ativo, setor responsável e prioridade.
  4. Se for início de contato WhatsApp, selecione um HSM aprovado e preencha suas variáveis.
  5. Informe assunto e descrição com o pedido recebido.
  6. Marque Assumir o chamado após abrir se você será o responsável; desmarque para encaminhar à fila.
  7. Revise o destinatário e confirme a abertura uma única vez.
  8. Para partir de um encerrado, use Novo chamado pelo WhatsApp e selecione o HSM; confira o protocolo novo.

Resultado esperado

Um novo atendimento é criado conforme o canal e o roteamento selecionados; o anterior permanece encerrado.

Observações importantes

  • Iniciar um WhatsApp pode enviar mensagem real ao destinatário.
  • É necessário ter ao menos um canal e um setor ativos.
  • Não repita uma abertura cujo resultado ainda esteja incerto sem consultar a lista.
  • O administrador pode abrir e assumir o chamado fora do horário nas versões com essa exceção. Quando a conversa vai para outra pessoa ou para a distribuição automática, continuam valendo as regras do horário humano.

Se precisar de ajuda

  • Sem modelos: confira aprovação e liberação por setor.
  • Canal ou setor indisponível: solicite revisão ao administrador.
Atendimentos

Abrir notificações e conferir alertas

Acompanhe novas conversas, mensagens não lidas, o contador da aba e os avisos sonoros.

Onde encontrarMenu → Notificações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Notificações e confira o atendimento associado ao aviso.
  2. Use a ação de abrir atendimento e confira o responsável e o status atuais, pois podem ter mudado.
  3. Em Meus atendimentos, observe o destaque do cartão enquanto houver mensagem do cliente ainda não lida pelo responsável.
  4. Consulte o contador no título da aba do navegador. Ele considera mensagens não lidas dos atendimentos atribuídos à sua conta.
  5. Para retirar a pendência de leitura, o responsável deve abrir e visualizar a conversa no painel.
  6. Se não ouvir o aviso, confira o volume, as permissões e se já interagiu com a página; navegadores podem suspender a reprodução.

Resultado esperado

A equipe identifica a conversa que aguarda leitura e abre o atendimento dentro das permissões da conta.

Observações importantes

  • Consultar uma conversa sem assumir, inclusive como administrador, não marca como lida para o atendente responsável.
  • Avisos de chegada à fila são apresentados à equipe autorizada e aos administradores; isso não equivale a atribuir automaticamente o atendimento a todos.
  • Destaque do cartão, número na aba, tempo sem resposta e status de entrega ao cliente são indicadores diferentes.
  • O contador pertence ao usuário autenticado e é removido ao sair. Som e avisos do dispositivo dependem das condições do navegador.
  • Esses comportamentos foram ampliados nas versões comerciais 1.0.34 a 1.0.38; confira a versão recebida pela sua instalação.

Se precisar de ajuda

  • Sem alerta sonoro: confira volume, permissões e interação com o navegador.
  • Atendimento inacessível: peça revisão do departamento e do escopo da conta.
Atendimentos

Entender reações nas mensagens

Leia os emojis ligados à mensagem original sem confundi-los com um novo pedido.

Onde encontrarAtendimento → mensagem original → reações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Localize a mensagem que recebeu a reação e confira o emoji exibido junto dela.
  2. Leia o contexto antes de interpretar um joinha, coração ou outro símbolo como concordância.
  3. Se o cliente trocar ou remover a reação, confira a atualização na própria mensagem.
  4. Para uma ação que exige confirmação explícita, siga o procedimento de identificação e autorização correspondente.

Resultado esperado

A reação fica associada à mensagem original, sem uma mensagem genérica de conteúdo desconhecido.

Observações importantes

  • No tratamento implementado para WhatsApp, uma reação isolada não abre atendimento, não aciona a IA e não inicia o indicador de digitação.
  • Trocas e remoções atualizam a reação; não representam novos envios de texto.
  • Um emoji, sozinho, não confirma pagamento nem autoriza desbloqueio ou alteração cadastral.
  • O comportamento depende do canal, da versão e da referência de mensagem recebida.

Se precisar de ajuda

  • Reação sem referência visível: informe ao suporte o canal e o horário, sem reenviar dados pessoais desnecessários.
Atendimentos

Identificar anúncios e distinguir os prazos do WhatsApp

Veja a origem informada pela Meta e confira separadamente o prazo para responder sem template e a isenção de cobrança.

Onde encontrarAtendimentos → conversa WhatsApp → Veio de anúncio / Veio de publicação

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Na lista de atendimentos, procure o selo Veio de anúncio. Ele depende de a Meta ter enviado a origem junto da mensagem.
  2. Abra a conversa e expanda Veio de anúncio ou Veio de publicação, quando disponível.
  3. Confira título, texto e identificador de origem que tenham sido recebidos. Use Abrir anúncio ou Abrir publicação se o link estiver disponível.
  4. Leia Envio sem template para saber se ainda pode responder com mensagem livre. Quando aparecer Prazo encerrado, utilize um HSM aprovado e compatível.
  5. Leia Isenção por origem separadamente. Um contador de gratuidade aparece somente quando a Meta confirmou um prazo válido.
  6. Se aparecer Prazo não confirmado pela Meta, mantenha a verificação do envio sem template e não suponha uma duração gratuita.

Resultado esperado

A equipe reconhece a origem do contato e decide a forma de resposta usando o prazo correto.

Observações importantes

  • Recurso documentado para o pacote comercial 1.0.61-pilot, sujeito à versão efetivamente instalada.
  • A janela de atendimento e a isenção por origem são informações independentes. A isenção pode estar aberta enquanto o envio sem template já exige HSM.
  • O contador usa o prazo confirmado pela Meta. O sistema não atribui um prazo fixo de gratuidade apenas porque o contato veio de anúncio.
  • Cada nova mensagem do cliente renova a janela de atendimento conforme a regra aplicada ao canal; isso não permite inferir uma nova isenção por anúncio.
  • Título, texto, identificador e link só aparecem quando disponíveis. A ausência do selo não prova que o cliente nunca viu um anúncio.
  • A interface diferencia anúncio de publicação. Reconhecer a origem não significa importar o painel completo de campanhas nem todas as métricas do anúncio.

Se precisar de ajuda

  • Origem sem detalhes: a Meta pode não ter enviado todos os campos. Consulte os dados disponíveis sem inventar a campanha.
  • Link ausente: o endereço pode não ter sido enviado ou não atender à validação do painel.
  • Gratuidade confirmada com resposta livre bloqueada: consulte Envio sem template; são prazos independentes.
Atendimentos

Agendar uma conversa e retomar o atendimento

Organize um retorno interno com data e horário, sem programar uma mensagem ao cliente.

Onde encontrarAtendimento → Agendar conversa; menu → Conversas agendadas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra um atendimento em andamento que já tenha responsável. Confira se você é o responsável ou administrador autorizado.
  2. Use Agendar conversa e selecione a data e o horário futuros. Confira o fuso do dispositivo informado no formulário.
  3. Se necessário, registre uma observação curta que explique o retorno esperado.
  4. Confirme o agendamento e localize a conversa em Conversas agendadas.
  5. No momento escolhido, acompanhe o aviso e a volta da conversa à operação. Se o cliente escrever antes, ela retorna imediatamente.
  6. Para antecipar o retorno manualmente, abra o agendamento e use Retomar agora quando disponível.

Resultado esperado

A conversa recebe um lembrete interno e pode ser retomada no prazo, por nova mensagem ou pela ação manual.

Observações importantes

  • Requer o módulo de agendamento de conversas liberado na licença, acesso ao atendimento e permissão para atribuição.
  • O agendamento aceita data futura em até um ano. A observação é opcional e respeita o limite do formulário.
  • Agendar não envia mensagem automaticamente ao cliente, não agenda campanha e não cria compromisso no IXC.
  • Cancelar fecha o formulário sem aplicar a edição pendente; para retirar um agendamento existente, use Retomar agora.
  • A observação e o rascunho pertencem à conversa selecionada. Confira o atendimento antes de confirmar.

Se precisar de ajuda

  • Comando ausente: confira módulo, permissão, responsável e situação do atendimento.
  • Data recusada: confira data futura, horário e fuso do dispositivo.
  • Falha ao salvar: revise a mensagem do formulário e consulte o estado da conversa antes de repetir.
Atendimentos

Ver quem está visualizando ou digitando na conversa

Use a presença dos colegas para coordenar a resposta sem confundi-la com atribuição ou leitura.

Onde encontrarAtendimento aberto → identificação de presença junto ao cabeçalho

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a conversa e mantenha a aba visível e em foco.
  2. Confira se o painel mostra outro colega como também visualizando ou digitando.
  3. Antes de responder, veja quem é o responsável e coordene a continuidade quando outra pessoa estiver preparando a mensagem.
  4. Ao trocar de conversa ou sair da aba, aguarde a atualização do indicador; ele é temporário.

Resultado esperado

Você identifica a atividade recente de colegas autorizados na mesma conversa.

Observações importantes

  • Requer o módulo de presença na conversa liberado na licença e acesso ao atendimento.
  • O indicador descreve colegas da equipe, não a conexão de internet ou a atividade do cliente.
  • Digitação só é informada para uma resposta permitida no atendimento; uma nota interna não deve aparecer como resposta sendo digitada ao cliente.
  • Visualizar não assume a conversa, não bloqueia outro envio e não limpa a pendência de leitura do responsável por outro usuário.
  • Ausência do aviso não prova que ninguém mais está trabalhando no caso. Falta de foco, atualização pendente ou indisponibilidade podem impedir a presença de aparecer.

Se precisar de ajuda

  • Presença indisponível: confira o responsável e continue a coordenação da equipe; não repita uma mensagem apenas por esse aviso.
  • Colega não aparece: confira se ambos têm acesso, estão na mesma conversa e mantêm a aba visível.
Atendimentos

Criar e executar ações rápidas no atendimento

Prepare uma sequência de mensagem, nota, etiqueta e encaminhamento para executar após revisão.

Onde encontrarAtendimento → Ações rápidas → Gerenciar minhas ações; Configurações → Mensagens rápidas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Em Ações rápidas, use Gerenciar minhas ações e escolha Nova ação rápida.
  2. Informe um nome e mantenha Ativa marcada quando a sequência estiver pronta. Administradores podem compartilhar a ação com a equipe.
  3. Adicione as etapas necessárias: enviar mensagem, nota interna, etiqueta, transferência ou encerramento. Preencha texto ou destino conforme a etapa.
  4. Use Subir e Remover para organizar até oito etapas. Transferir ou encerrar deve ficar por último; revise a opção de pesquisa quando apresentada.
  5. Salve a ação rápida. Para executar, volte ao atendimento correto e confira responsável, cliente e a sequência exibida.
  6. Clique em Executar uma única vez. Leia o resultado de cada etapa e confira as mensagens no histórico.
  7. Se aparecer execução em andamento, use Atualizar resultado. Em falha ou retorno incerto, confira o que já foi aplicado antes de executar outra sequência.

Resultado esperado

A sequência aplica as operações autorizadas e apresenta o resultado de cada etapa.

Observações importantes

  • Requer o módulo de ações rápidas liberado na licença e as permissões de todas as operações da sequência.
  • Ações pessoais são mantidas pelo próprio usuário. Compartilhar com a equipe e editar ações compartilhadas exige administração.
  • Uma resposta rápida apenas ajuda a preencher um texto; uma ação rápida pode enviar mensagens, transferir ou encerrar de fato.
  • Os envios respeitam a janela e as regras do canal. Uma mensagem aceita pode ainda aguardar entrega.
  • Transferências continuam verificando horário, capacidade e disponibilidade. Fora do expediente, a conversa pode ficar em fila e o aviso ao cliente depende das condições de envio.
  • Uma falha não desfaz automaticamente etapas já aplicadas. Não crie outra execução para tentar repetir sem revisar o histórico.

Se precisar de ajuda

  • Nenhuma ação disponível: confira se a ação está ativa e se é pessoal ou compartilhada com a equipe.
  • Permissão recusada: peça revisão das operações da sequência, sem tentar contornar pelo envio repetido.
  • Resultado parcial: confira o resultado por etapa e dê continuidade somente ao que falta.
Clientes e IXC

Localizar clientes e consultar seus atendimentos

Encontre os contatos recebidos pelos canais e veja seus vínculos e protocolos.

Onde encontrarMenu → Clientes

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Clientes e use a busca por dados do contato.
  2. Aplique os filtros oferecidos, como vínculo com IXC ou atendimentos abertos.
  3. Selecione o contato correto e confira a identidade do canal.
  4. Consulte o histórico e abra o protocolo que deseja revisar.
  5. Use Atualizar para consultar os dados novamente.
  6. Avance a paginação para localizar outros registros.

Resultado esperado

O contato e seus atendimentos autorizados ficam disponíveis para consulta.

Observações importantes

  • Um contato recebido pelo canal não é necessariamente um assinante já vinculado ao ERP.
  • Consentimento de WhatsApp é uma informação específica por categoria; não deve ser presumido apenas porque há cadastro.

Se precisar de ajuda

  • Contato não localizado: confira telefone com DDD e os filtros.
  • Vínculo incorreto: use o procedimento de revisão no contexto IXC.
Clientes e IXC

Localizar, vincular e desvincular o assinante IXC

Confirme a identidade do assinante antes de consultar ou executar ações no ERP.

Onde encontrarAtendimento → Contexto do cliente → Localizar e vincular cliente

Antes de começar

  • Tenha integração IXC configurada e permissão de consulta.
  • Siga o procedimento de identificação da empresa.

Passo a passo

  1. Abra o contexto do cliente e confira se há cadastro identificado ou vínculo anterior.
  2. Se o cadastro não estiver correto, use Localizar e vincular cliente. Informe CPF/CNPJ ou o nome cadastral quando o campo oferecer essa busca.
  3. CPF e CNPJ podem conter espaços e pontuação nas versões atuais; a validação dos dígitos continua sendo feita.
  4. Compare nome, endereço e os dados necessários com o cliente. Se houver mais de um cadastro, escolha explicitamente o correto.
  5. Confira se o titular já foi confirmado ou se o cadastro ainda aguarda confirmação. Encontrar um resultado não equivale a confirmá-lo.
  6. Confirme o vínculo correto e atualize o contexto antes de executar uma ação.
  7. Para corrigir um vínculo indevido, desvincule conforme a confirmação da tela e identifique novamente o cadastro certo.

Resultado esperado

O contexto passa a consultar o assinante selecionado.

Observações importantes

  • Não escolha o primeiro resultado apenas pela semelhança do nome.
  • Na automação documentada, a confirmação apresenta nome e endereço disponível. Se o cliente indicar outro cadastro, a identificação recomeça preservando o pedido já informado.
  • A lateral pode mostrar cadastro identificado ou titular confirmado. Esses estados são diferentes; respeite a confirmação exigida antes de enviar dados ou executar ações.
  • Informar espaços no documento não dispensa a validação dos dígitos. Não remova números para forçar um resultado.

Se precisar de ajuda

  • Sem resultado: confira documento e conexão com o IXC.
  • Mais de um cadastro: confirme informações com o titular; não adivinhe.
Clientes e IXC

Consultar contratos, conexão e serviços do IXC

Leia os dados do assinante na lateral da conversa sem sair do atendimento.

Onde encontrarConversa → Contexto do cliente → IXC

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confirme o cadastro e o vínculo do assinante. Na lateral, veja se o titular está confirmado ou ainda aguarda confirmação.
  2. Abra IXC e consulte a visão geral com nome cadastral, endereço e telefones disponíveis.
  3. Confira contratos, faturas abertas, logins online e alertas de acesso.
  4. Abra os contratos para consultar plano, situação cadastral e acesso do serviço correto.
  5. Consulte Produtos do plano e Acessos de aplicativos e TV somente quando necessários e permitidos.
  6. Use Atualizar antes de uma decisão que dependa da situação atual no ERP.

Resultado esperado

Você obtém o contexto retornado pelo ERP para orientar o atendimento.

Observações importantes

  • Um indicador online ou offline é a resposta da consulta; não é uma medição contínua de toda a rede.
  • Informações de acesso a aplicativos podem ser sensíveis e devem seguir a confirmação de identidade.
  • A consulta não altera contrato nem confirma automaticamente uma falha técnica.
  • O nome identificado na lateral pode vir do contexto já registrado, sem uma nova consulta de contratos e faturas. Para uma operação atual, confira os dados na consulta IXC.

Se precisar de ajuda

  • Contexto vazio: confira vínculo, permissão e disponibilidade do IXC.
  • Cadastro com vários contratos: confira qual serviço o cliente está mencionando.
Clientes e IXC

Enviar segunda via e Pix pelo atendimento

Consulte os títulos em aberto e envie a cobrança correspondente ao pedido do cliente.

Onde encontrarConversa → IXC → Faturas abertas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Identifique o titular e confirme o vínculo correto.
  2. Abra as faturas e compare vencimento, valor e contrato.
  3. Selecione o título solicitado; não presuma que o primeiro é sempre o correto.
  4. Escolha a ação disponível para boleto/segunda via ou Pix.
  5. Confira o destinatário e confirme o envio solicitado pela tela.
  6. Acompanhe o resultado na conversa e explique ao cliente o que foi enviado.

Resultado esperado

O sistema utiliza os dados retornados pelo IXC para enviar o documento ou o Pix quando disponíveis.

Observações importantes

  • Nunca crie uma chave Pix ou um valor por conta própria.
  • O envio não dá baixa financeira e não comprova pagamento.
  • Respeite a janela de mensagem e as regras do canal.
  • A mensagem de Pix pode apresentar vencimento e valor da fatura, com o código separado para facilitar a cópia. Confira esses dados antes de orientar o pagamento.
  • Cobranças pela ponte IXC conferem a situação do título antes do envio e das novas tentativas. Um título pago, cancelado, ambíguo ou sem consulta confiável pode impedir o envio.
  • Pedir novamente a cobrança não corrige a causa de um bloqueio financeiro; confira a fatura e o motivo registrado.
  • A partir da versão 1.0.63-pilot, a resposta automática sobre atraso considera faturas ainda abertas com vencimento anterior ao dia atual no fuso da empresa. Faturas que vencem hoje ou no futuro não são contadas como atrasadas. Isso não equivale a confirmar pagamento.

Se precisar de ajuda

  • Nenhuma fatura aberta: atualize e confira se o cliente ou contrato é o correto.
  • Pix ou PDF indisponível: confira a resposta do IXC e encaminhe ao financeiro.
Clientes e IXC

Consultar e enviar nota fiscal

Localize as notas vinculadas aos títulos do cliente e solicite o PDF pelo IXC.

Onde encontrarConversa → IXC → Notas fiscais

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confirme o cliente vinculado e abra as notas fiscais.
  2. Compare número, emissão, valor e título relacionado.
  3. Selecione a nota correta e use a ação de envio de PDF quando disponível.
  4. Confirme a operação apresentada e aguarde o retorno.
  5. Confira o registro do envio na conversa.

Resultado esperado

O PDF gerado pelo IXC é encaminhado na conversa quando a integração disponibiliza a operação.

Observações importantes

  • O período de exibição pode ser configurado nas preferências IXC.
  • Consultar uma nota não altera dados fiscais.
  • Ausência de PDF disponível não significa ausência de obrigação fiscal.

Se precisar de ajuda

  • Sem notas: confira vínculo, títulos e período configurado.
  • Erro no PDF: solicite conferência ao responsável pelo IXC.
Clientes e IXC

Solicitar desbloqueio de confiança

Execute a ação disponível para um contrato elegível com confirmação do cliente correto.

Onde encontrarConversa → IXC → ação de desbloqueio

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confirme a identidade e o contrato ao qual o cliente se refere.
  2. Atualize a situação do contrato e do acesso.
  3. Se a opção de desbloqueio estiver disponível, leia a confirmação e confira o contrato selecionado.
  4. Confirme uma única vez e aguarde a resposta do IXC.
  5. Consulte novamente a situação e informe o resultado efetivamente retornado.

Resultado esperado

O IXC aceita ou recusa a solicitação conforme suas regras; o atendimento recebe o resultado.

Observações importantes

  • Desbloqueio de confiança não é confirmação de pagamento nem baixa de título.
  • Não prometa duração ou disponibilidade além da política definida no ERP.
  • Enviar comprovante não autoriza automaticamente a liberação.
  • Nas versões com a conferência de liberação, o sistema consulta o contrato após o retorno do IXC. Só comunica sucesso quando a situação confirma o desbloqueio; recusa ou resultado não confirmado exige revisão da equipe com o motivo disponível.

Se precisar de ajuda

  • Contrato não elegível ou erro: encaminhe ao setor responsável com o retorno registrado.
  • Resposta incerta: consulte a situação antes de repetir.
Clientes e IXC

Consultar chamados e criar uma ordem de serviço

Abra uma OS com as opções retornadas pelo IXC e acompanhe as informações do técnico.

Onde encontrarConversa → IXC → Chamados e OS → Criar OS

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Tipo, assunto e métodoEscolha entre os itens retornados pelo IXC.
Contrato e loginServiço ao qual a OS se refere.
Filial, empresa e técnicoDestinos permitidos no ERP.
PrioridadeBaixa, normal, alta ou crítica conforme a situação.
Descrição e observaçãoRelato necessário e nota interna quando aplicável.
AgendamentoPreencha se houver data combinada.

Passo a passo

  1. Confira os chamados e OS existentes para evitar duplicidade.
  2. Clique em Criar OS.
  3. Selecione tipo de ocorrência, assunto, método e filial entre as opções disponíveis.
  4. Selecione contrato e login correspondentes ao problema.
  5. Preencha motivo, prioridade e descrição do atendimento. Informe técnico, empresa, observação interna e agendamento quando aplicáveis.
  6. Revise o cliente e confirme a criação.
  7. Atualize a lista e anote o identificador retornado. Abra o item para consultar abertura, motivo e fechamento do técnico.

Resultado esperado

Uma OS é criada no IXC quando o ERP confirma a operação.

Observações importantes

  • Os campos e opções vêm do IXC.
  • Um contrato sem login vinculado pode impedir selecionar uma conexão.
  • A tela consulta o fechamento; não representa um formulário universal para concluir o trabalho técnico.

Se precisar de ajuda

  • Lista de opções vazia: confira a integração e as permissões no IXC.
  • Falha após confirmar: consulte a lista antes de criar outra OS.
Clientes e IXC

Conferir imagens e comprovantes recebidos

Use a interpretação da imagem como apoio e confira a situação real no financeiro.

Onde encontrarConversa → imagem recebida; IXC → faturas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra o arquivo original recebido pelo cliente.
  2. Leia a descrição ou extração da IA, quando disponível.
  3. Confira valor, data, favorecido e se a imagem indica pagamento realizado, agendado, pendente ou falho.
  4. Atualize a situação financeira no IXC.
  5. Encaminhe casos sem confirmação ao financeiro e registre o que foi verificado em nota interna.

Resultado esperado

O atendimento diferencia o conteúdo da imagem da situação financeira confirmada no ERP.

Observações importantes

  • Uma imagem não prova autenticidade ou liquidação.
  • A IA não deve transformar um agendamento em pagamento concluído.
  • Não desbloqueie apenas com base no texto interpretado.
  • Dados de identificação enviados enquanto a imagem está sendo analisada devem ser lidos junto do pedido já informado. A conferência financeira e a confirmação do cadastro continuam necessárias.

Se precisar de ajuda

  • Imagem ilegível: solicite as informações necessárias conforme o procedimento da empresa.
  • Dados divergentes: registre a divergência e encaminhe à conferência humana.
Clientes e IXC

Preparar um modelo de cobrança com Pix e PDF

Envie o modelo para análise e use o documento e o Pix da própria fatura na integração IXC.

Onde encontrarIntegrações → número WhatsApp → Novo modelo de mensagem; Integrações → IXC

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira a conexão do número e abra Novo modelo de mensagem.
  2. No campo Formato, escolha Cobrança com Pix e PDF, quando essa opção estiver disponível.
  3. Revise o nome, o texto e os exemplos. O formulário prepara a categoria de utilidade, o idioma e os componentes necessários.
  4. Envie para análise da Meta. O exemplo de documento é fictício; aguarde a aprovação antes de usar o modelo em cobranças.
  5. Após aprovação, selecione o modelo na configuração de cobrança do IXC e confira as variáveis de nome, valor e vencimento.
  6. Se o Pix dinâmico não informar a chave do recebedor, abra Integrações → IXC → Cobrança com Pix e PDF. Complete nome, tipo e chave com os dados da mesma conta bancária configurada no IXC e use Salvar dados Pix.
  7. Homologue com um destinatário autorizado e uma fatura de teste adequada. Confira documento, vencimento, valor e código antes de liberar o uso operacional.

Resultado esperado

Um modelo aprovado pode combinar PDF, valor e botão Copiar código Pix usando a fatura consultada no IXC.

Observações importantes

  • O recurso depende das versões com cobrança Pix/PDF, da integração IXC e da aprovação da Meta. Criar o modelo não ativa uma cobrança automaticamente.
  • O Pix vem da própria fatura. Os dados complementares do recebedor não autorizam substituir o código por uma cobrança inventada.
  • A situação da fatura é conferida durante a preparação e antes do envio; títulos já pagos ou sem identificação confiável podem ser bloqueados.
  • O cartão pode mostrar a identificação do título IXC. Reenvios distintos podem ter complemento na referência, enquanto novas tentativas da mesma mensagem preservam a referência.

Se precisar de ajuda

  • Modelo pendente: aguarde a análise; salvar no painel não equivale a aprovação.
  • Recebedor incompleto: confira os dados bancários reais no IXC antes de preencher a configuração.
  • Cobrança bloqueada: consulte a situação da fatura e o motivo em Indicadores e relatórios → Envios de cobrança IXC. Não repita um envio com resultado incerto.
Clientes e IXC

Conferir comprovante Pix pelo IXC

Entenda como a automação verifica a baixa do boleto e quando encaminha a conversa para a equipe.

Onde encontrarAtendimento automático → imagem de comprovante → consulta ao IXC

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira se a instalação já recebeu a versão 1.0.65-pilot ou posterior e se o fluxo de atendimento utiliza esse recurso.
  2. A automação precisa do cadastro confirmado e de uma referência inequívoca do boleto daquele cliente para consultar a situação no IXC.
  3. Se o IXC retornar o boleto como recebido, o cliente recebe uma confirmação de baixa, com o vencimento quando disponível.
  4. Se o pagamento continuar pendente ou houver indisponibilidade temporária, o sistema agenda uma nova consulta após dois minutos, sem mensagens intermediárias de análise ou espera.
  5. Depois da nova consulta, o sistema confirma a baixa ou encaminha à equipe. Fora do horário geral, o encaminhamento informa a condição de atendimento.
  6. Se o atendente assumir, o cadastro mudar, o atendimento encerrar ou o cliente mudar de assunto, a conferência antiga deixa de prosseguir.

Resultado esperado

O cliente recebe uma confirmação baseada na consulta ao ERP ou é encaminhado para conferência humana.

Observações importantes

  • A imagem, sozinha, não confirma pagamento. Ausência de fatura, título cancelado ou saldo zero não substituem o status de recebido no IXC.
  • Quando não for possível identificar um único boleto com segurança, a automação encaminha à equipe.
  • Esta rotina somente consulta: não faz baixa financeira nem desbloqueia a internet por conta própria.
  • Uma atualização documentada precisa estar instalada e o fluxo correspondente precisa estar em uso.

Se precisar de ajuda

  • Confira identificação do cliente, referência do título, integração IXC e versão instalada.
  • O atendente pode continuar a conversa com o histórico disponível, sem aguardar uma consulta automática antiga.
Clientes e IXC

Trocar o telefone e impedir cobranças para o número antigo

Mantenha o cadastro do IXC correto e entenda a proteção dos envios automáticos pendentes.

Onde encontrarIXC → cadastro do cliente; Omnichannel → Envios de cobrança IXC

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira o cadastro do cliente no IXC e informe o novo telefone real nos campos pertinentes.
  2. Remova o telefone antigo de todos os campos em que ele deixou de ser válido, incluindo telefones secundários.
  3. Nas versões a partir de 1.0.64-pilot, a ponte confere o destinatário na entrada da cobrança e antes de enviar. A varredura periódica também revisa as cobranças pendentes.
  4. Quando o cadastro atual completo confirma que o telefone não pertence mais ao cliente, o envio pendente é cancelado logicamente e recebe o motivo correspondente no relatório.
  5. Consulte o relatório de cobranças para conferir o motivo. Prepare uma nova cobrança válida para o novo telefone quando for necessário; uma mensagem cancelada não é redirecionada nem reativada automaticamente.

Resultado esperado

Cobranças pendentes e novas tentativas não seguem para um telefone confirmado como removido do cadastro.

Observações importantes

  • A proteção se aplica às cobranças automáticas da ponte IXC. Não bloqueia globalmente respostas humanas, campanhas ou outros canais.
  • Se o número antigo continuar em outro campo do mesmo cadastro no IXC, ele permanece associado ao cliente.
  • Falha de consulta não prova troca de telefone: o envio fica retido para conferência, sem autorizar a cobrança por ausência de resposta.
  • A varredura não é instantânea. O tempo depende da fila e da disponibilidade do IXC; cada envio também passa por sua própria checagem.
  • Mensagens já aceitas pelo WhatsApp não podem ser recolhidas por essa regra. O histórico e os atendimentos anteriores são preservados.

Se precisar de ajuda

  • Se ainda houver envio, confira todos os campos telefônicos do IXC, a versão instalada, a origem da mensagem e a hora em que ela foi aceita pelo canal.
  • Não troque o telefone de um contato histórico apenas para mudar o destino de cobranças: o histórico pertence ao contato original.
Canais de atendimento

Conectar e ativar o WhatsApp

Autorize a conta da empresa e confira o número antes de ativar o atendimento.

Onde encontrarAdministração → Integrações → WhatsApp → Conexão

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Em Integrações, escolha o cartão do número ou a opção para adicionar uma conexão WhatsApp.
  2. Escolha a conexão automática pelo login oficial da Meta e entre com uma conta autorizada para os ativos da empresa.
  3. Siga o assistente e selecione a empresa, a conta WhatsApp Business e o número corretos.
  4. Ao retornar ao Omnichannel, confira o número e a empresa identificados. Não confirme outro ativo apenas para avançar.
  5. Se solicitado, informe ou defina o PIN de verificação em duas etapas do número e guarde-o de forma protegida.
  6. Use Ativar atendimento quando a conexão estiver conferida e aguarde o resultado.
  7. Atualize o status, selecione um fluxo de entrada ativo e publicado e homologue com um contato da equipe autorizado.

Resultado esperado

O número selecionado passa a ser utilizado pelo Omnichannel após a ativação bem-sucedida.

Observações importantes

  • A conexão atual é mantida até a ativação do novo número no assistente.
  • Se a conexão indicar coexistência com WhatsApp Business, o aplicativo pode continuar disponível; histórico anterior e mensagens enviadas por ele não são sincronizados por esta implementação.
  • A conexão exige aplicativo Meta e permissões previamente preparados para sua instalação.
  • Nas versões com vários números, acrescentar uma conexão preserva os canais existentes; confira sempre qual número está sendo configurado.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.
  • Inicie Conectar automaticamente no Omnichannel para concluir a autorização com o retorno correto. Abrir o painel externo serve para preparar e administrar a conta; não conecta o canal por si só. O cliente não precisa criar outro aplicativo Meta quando utiliza o aplicativo já oferecido pelo fornecedor.

Se precisar de ajuda

  • Assistente indisponível: solicite ao suporte a configuração do aplicativo e confira os avisos de diagnóstico.
  • Janela não abre: confira bloqueio de pop-up e a sessão Meta.
  • Número não encontrado: confirme acesso à empresa e ao ativo.
Canais de atendimento

Conectar uma API oficial do WhatsApp pelos dados da conta

Informe as credenciais autorizadas, valide o número e confira a ativação separadamente.

Onde encontrarConfigurações → Integrações → cartão do número WhatsApp → Conexão manual

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Tenha permissão para administrar o canal e o recurso disponível na sua versão.
  • Obtenha os IDs e o token da conta oficial com o responsável técnico. O token precisa ter acesso ao aplicativo Meta, à conta e ao número indicados.

Passo a passo

  1. Em Integrações, localize o cartão do número que deseja configurar. Confira o nome e o telefone antes de abrir a conexão.
  2. Escolha o método manual e preencha ID da conta WhatsApp Business (WABA), ID do número de telefone e Token de acesso.
  3. Em um cartão de número já identificado, o ID do número pode ficar fixo. Para outro número, use o procedimento de adicionar uma conexão.
  4. Clique em Validar conta existente e aguarde o resultado. A validação confere a autorização; ainda não ativa o atendimento.
  5. Se houver recusa, leia o erro e confira os IDs preservados. O token pode ser limpo após a tentativa e precisar ser informado novamente.
  6. Após validar, confira a empresa e o número retornados. Conclua Ativar atendimento quando a conexão estiver correta e pronta para operar.
  7. Atualize o status e revise o fluxo de entrada. Homologue com uma conta de teste autorizada antes de iniciar a operação.

Resultado esperado

A conta e o número são validados; o atendimento só é ativado após a etapa correspondente.

Observações importantes

  • O formulário editável pertence às versões comerciais a partir de 1.0.55; a versão 1.0.60 separa melhor validação e ativação. Instalações anteriores podem apresentar outro procedimento.
  • Validar credenciais, salvar preferências e ativar o atendimento são ações diferentes.
  • Não cole tokens em conversas, notas, imagens de suporte ou páginas públicas. Use somente os campos protegidos da integração.
  • Se o número está em outro sistema, confirme com o responsável o procedimento de conexão ou migração antes de alterar a operação.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Campos ausentes: confira a versão, o cartão selecionado e sua permissão administrativa.
  • Token recusado: confira aplicativo Meta, acesso à WABA e ao número; não utilize a senha de login do Omnichannel nesse campo.
  • Canal desconectado: conclua a validação e a ativação; salvar somente as preferências não conecta o número.
Canais de atendimento

Criar, revisar e excluir modelos WhatsApp

Cadastre templates e acompanhe a aprovação antes de disponibilizá-los à equipe.

Onde encontrarAdministração → Integrações → WhatsApp → modelos de mensagem

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a área de modelos e escolha Novo modelo de mensagem.
  2. Informe nome, idioma e categoria condizente com o conteúdo.
  3. Preencha o corpo; configure cabeçalho, rodapé e botões quando necessários.
  4. Adicione variáveis e seus exemplos conforme o formulário.
  5. Escolha os departamentos autorizados a usar o modelo. Sem seleção, ele fica disponível para todos os departamentos permitidos pelo sistema.
  6. Revise a pré-visualização e envie para análise.
  7. Atualize a lista e acompanhe a situação retornada pela Meta. Somente utilize modelos aprovados.
  8. Para alterar o acesso por setor, abra Permissões do modelo e salve os departamentos.
  9. Para remover um modelo, use Excluir e confirme no diálogo do painel. Aguarde a confirmação externa.

Resultado esperado

O modelo fica cadastrado para análise e, após aprovação, pode ser utilizado conforme a política do setor.

Observações importantes

  • Marketing, Utilitário e Autenticação são categorias com finalidades diferentes; a classificação final depende da Meta.
  • Modelos em exclusão pendente não devem receber uma nova solicitação de exclusão.
  • Uma falha de exclusão externa mantém o registro local.
  • Nas versões com coluna Formato, confira também a estrutura e a compatibilidade de envio. Um Carrossel aprovado pela Meta pode aparecer na lista com Envio ainda indisponível.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Modelo rejeitado: leia o motivo e revise texto, exemplos e categoria.
  • Exclusão sem permissão: o administrador precisa conferir o acesso aos modelos da conta WhatsApp Business.
  • Modelo aprovado ausente: confira idioma, setor e sincronização.
Canais de atendimento

Atualizar perfil e consultar registros do WhatsApp

Confira os dados públicos do número e os registros disponíveis na integração.

Onde encontrarAdministração → Integrações → WhatsApp → Perfil / Cadastro / Registros

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a integração do WhatsApp e confira a conta e o número conectados.
  2. Em Perfil, revise os campos públicos que a tela permite alterar e salve as mudanças necessárias.
  3. Em Cadastro, confira os identificadores e a situação apresentada.
  4. Abra Registros para localizar erros recentes e baixar logs quando houver essa opção.
  5. Após corrigir uma configuração, atualize o estado para confirmar o resultado.

Resultado esperado

O perfil e os registros ajudam a conferir o número e diagnosticar o canal.

Observações importantes

  • Dados públicos alterados podem aparecer para os contatos do canal.
  • Recursos de chamadas dependem da configuração de telefonia; um cartão de chamadas não comprova PABX integrado.
  • Nas versões com vários números, abra primeiro o cartão do canal correto. As ações de perfil e os registros são consultados no contexto dessa seleção.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Alteração não aplicada: leia o erro externo e confira permissão sobre o número.
  • Logs devem ser enviados ao suporte pelo meio definido pela empresa, com cuidado com dados pessoais.
Canais de atendimento

Conectar Instagram Direct

Conecte a conta profissional Business ou Creator e encaminhe mensagens ao fluxo correto.

Onde encontrarAdministração → Integrações → Instagram

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Instagram e escolha a conexão automática, quando disponível.
  2. Entre na Meta com uma conta autorizada e selecione a conta profissional Business ou Creator correta.
  3. Confirme os acessos do assistente e aguarde o retorno ao Omnichannel.
  4. Confira o cadastro e use Sincronizar para consultar a situação.
  5. Se precisar da configuração manual, preencha os identificadores, o token específico do canal e a chave secreta do aplicativo nos campos protegidos.
  6. No cadastro técnico da Meta, use exatamente URL de retorno e token de verificação mostrados na tela.
  7. Confira a assinatura da conta ou Página e, se necessário, use Assinar novamente.
  8. Selecione o fluxo de entrada publicado e salve o atendimento.

Resultado esperado

As mensagens da conta profissional Business ou Creator passam a ser recebidas quando conexão, autorização e webhook estiverem válidos.

Observações importantes

  • A configuração depende do aplicativo Meta, suas permissões e ativos autorizados.
  • Credenciais de Instagram, Página e WhatsApp não devem ser tratadas como intercambiáveis.
  • Salvar dados não prova recebimento real: homologue com uma conta de teste autorizada.
  • Nas versões com o fluxo de entrada para stories, uma menção isolada pode ser encerrada sem resposta automática e sem pesquisa. Respostas a stories, publicações compartilhadas e conversas em andamento continuam sendo tratadas como conversa.
  • Esse tratamento depende do evento recebido e do fluxo de entrada configurado; não desative todas as mensagens de stories para evitar uma menção isolada.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.
  • Inicie Conectar automaticamente no Omnichannel para concluir a autorização com o retorno correto. Abrir o painel externo serve para preparar e administrar a conta; não conecta o canal por si só. O cliente não precisa criar outro aplicativo Meta quando utiliza o aplicativo já oferecido pelo fornecedor.

Se precisar de ajuda

  • Sem mensagens: consulte Registros, assinatura e situação do canal.
  • Conta ausente no assistente: confira o acesso do usuário aos ativos da empresa.
Canais de atendimento

Conectar Facebook Messenger

Conecte a Página do Facebook e encaminhe mensagens ao fluxo correto.

Onde encontrarAdministração → Integrações → Facebook Messenger

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Facebook Messenger e escolha a conexão automática, quando disponível.
  2. Entre na Meta com uma conta autorizada e selecione a Página do Facebook correta.
  3. Confirme os acessos do assistente e aguarde o retorno ao Omnichannel.
  4. Confira o cadastro e use Sincronizar para consultar a situação.
  5. Se precisar da configuração manual, preencha os identificadores, o token específico do canal e a chave secreta do aplicativo nos campos protegidos.
  6. No cadastro técnico da Meta, use exatamente URL de retorno e token de verificação mostrados na tela.
  7. Confira a assinatura da conta ou Página e, se necessário, use Assinar novamente.
  8. Selecione o fluxo de entrada publicado e salve o atendimento.

Resultado esperado

As mensagens da Página do Facebook passam a ser recebidas quando conexão, autorização e webhook estiverem válidos.

Observações importantes

  • A configuração depende do aplicativo Meta, suas permissões e ativos autorizados.
  • Credenciais de Instagram, Página e WhatsApp não devem ser tratadas como intercambiáveis.
  • Salvar dados não prova recebimento real: homologue com uma conta de teste autorizada.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.
  • Inicie Conectar automaticamente no Omnichannel para concluir a autorização com o retorno correto. Abrir o painel externo serve para preparar e administrar a conta; não conecta o canal por si só. O cliente não precisa criar outro aplicativo Meta quando utiliza o aplicativo já oferecido pelo fornecedor.

Se precisar de ajuda

  • Sem mensagens: consulte Registros, assinatura e situação do canal.
  • Conta ausente no assistente: confira o acesso do usuário aos ativos da empresa.
Canais de atendimento

Conectar e administrar um bot Telegram

Cadastre um bot oficial, configure seu perfil e reconecte o webhook quando necessário.

Onde encontrarConfigurações → Integrações → Telegram

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra o BotFather pelo atalho acima. Use /newbot para criar um bot ou /mybots para administrar um existente da empresa.
  2. Obtenha o token do bot. No Omnichannel, preencha Token do BotFather e Nome interno do canal.
  3. Salve a conexão e confira o resultado da validação.
  4. Revise nome público, descrição e descrição curta. Selecione um fluxo de entrada ativo e publicado e salve.
  5. No Telegram, abra o bot com uma conta de teste autorizada e inicie a conversa. Confira a chegada no Omnichannel.
  6. Use Atualizar status para consultar a conexão. Se a recepção falhar, leia os registros e use Reconectar webhook após corrigir a causa.
  7. Use Desconectar somente quando a operação desse bot deva ser interrompida.

Resultado esperado

O bot pode receber as mensagens iniciadas pelos contatos e encaminhá-las ao Omnichannel.

Observações importantes

  • A integração utiliza um bot da Bot API. Não exige api_id/api_hash de uma conta pessoal em my.telegram.org.
  • O token fica protegido após salvar. Ao editar, siga a indicação da tela para manter a credencial atual.
  • O mesmo bot não deve ter seu webhook configurado simultaneamente por outro sistema.
  • O contato precisa iniciar uma conversa com o bot. Conectar o bot não importa automaticamente os contatos de uma conta pessoal.

Se precisar de ajuda

  • Token inválido: confira a credencial do bot correto.
  • Bot sem mensagens: confira o webhook e se o usuário iniciou uma conversa com ele.

Referências oficiais

Canais de atendimento

Instalar o chat no site ou WordPress

Crie o canal do site, autorize as origens e copie o código do widget.

Onde encontrarAdministração → Integrações → Chat do site

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Clique em Adicionar site ou escolha um canal existente.
  2. Preencha nome do site/canal e nome exibido no atendimento.
  3. Configure mensagem de boas-vindas, cor principal, posição e tempo de abertura automática.
  4. Selecione o fluxo de entrada publicado.
  5. Em Endereços autorizados, informe uma origem por linha, por exemplo https://www.exemplo.com.br, sem caminhos. Inclua a versão sem www se também for usada.
  6. Salve e copie Código para instalar no site.
  7. No WordPress ou Elementor, use o código no modelo global/rodapé que permita scripts. Em HTML, inclua antes de </body>.
  8. Limpe o cache e abra o site em outro navegador. Inicie uma conversa de homologação com dados fictícios.

Resultado esperado

O widget aparece nas páginas que carregam o código e cuja origem está autorizada.

Observações importantes

  • Cada site pode ter seu próprio canal e fluxo.
  • O WordPress pode remover scripts de blocos conforme a permissão do usuário ou o editor; utilize a área de código autorizada da hospedagem/tema.
  • Instalar este widget é diferente de instalar esta wiki.

Se precisar de ajuda

  • Widget ausente: confira código publicado, origem exata, HTTPS e cache.
  • Fluxo não iniciou: confira se o canal tem um fluxo ativo e publicado.
Canais de atendimento

Usar o chat do site como cliente

Inicie uma conversa, forneça os dados solicitados e mantenha a continuidade no navegador.

Onde encontrarSite da empresa → botão do chat

Antes de começar

  • Acesse um site em que o chat da empresa esteja instalado.

Passo a passo

  1. Abra o site e clique no botão de atendimento.
  2. Preencha os dados pedidos no cadastro do chat.
  3. Descreva a solicitação com suas palavras e envie.
  4. Responda às perguntas necessárias e compartilhe anexos apenas quando pertinentes.
  5. Aguarde o robô ou a equipe; se estiver fora do expediente, leia o aviso e a previsão de atendimento.
  6. Reabra o chat no mesmo navegador para consultar a continuidade disponível.

Resultado esperado

A solicitação entra no canal webchat da empresa e fica disponível à operação.

Observações importantes

  • Limpar dados do navegador ou trocar de dispositivo pode afetar a continuidade local.
  • Não envie senha bancária ou códigos de acesso à sua conta.
  • Os campos de identificação e as mensagens são definidos pela empresa.

Se precisar de ajuda

  • Chat não abre: atualize a página e confira a conexão.
  • Se o histórico não aparecer em outro dispositivo, informe o protocolo pelo canal oficial da empresa.
Canais de atendimento

Receber o resultado do teste de velocidade no chat

Associe o resultado disponível de um teste compatível ao atendimento iniciado pelo cliente.

Onde encontrarIntegrações → Chat do site → Domínio do site de teste de velocidade

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Como administrador, configure o domínio HTTPS do teste de velocidade e inclua a origem nos endereços autorizados.
  2. Instale a integração de resultado compatível com o widget no site do teste, com apoio do responsável técnico.
  3. Como cliente, conclua o teste e abra o atendimento pelo chat.
  4. Complete o cadastro solicitado.
  5. Como atendente, confira a imagem do resultado anexada à conversa e use-a junto com os demais dados do suporte.

Resultado esperado

O resultado disponível pode ser associado à conversa após o cliente solicitar atendimento.

Observações importantes

  • O teste sozinho não abre um protocolo.
  • A compatibilidade documentada é com resultados LibreSpeed e a ponte de integração do site.
  • O resultado é uma medição pontual; não deve ser tratado como diagnóstico completo.

Se precisar de ajuda

  • Sem imagem: confira a integração do teste, o domínio autorizado e se o cadastro do chat foi concluído.
Canais de atendimento

Escolher o fluxo de entrada de um canal

Defina qual automação recebe as novas conversas em cada canal.

Onde encontrarAdministração → Integrações → canal → Atendimento / Fluxo de entrada

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Prepare e publique o fluxo em Fluxos de atendimento.
  2. Abra a integração do canal desejado.
  3. Localize Fluxo de entrada e selecione o fluxo publicado.
  4. Salve a configuração.
  5. Inicie uma nova conversa de homologação e confira o caminho seguido.

Resultado esperado

Novas entradas passam a usar o fluxo configurado conforme o estado do atendimento.

Observações importantes

  • Sem fluxo automático é uma opção diferente de canal desconectado.
  • Alterar a entrada não reescreve mensagens ou o histórico dos protocolos anteriores.
  • Fluxos e agentes precisam estar ativos e publicados quando exigidos.
  • Confira tanto a publicação quanto o estado Ativo. A ação Ativar fluxo pode passar a executar o fluxo em vínculos já existentes; revise os canais antes de ativar.

Se precisar de ajuda

  • Fluxo não aparece: confira publicação e ativação.
  • Conversa continua em outra etapa: verifique se já existia atendimento em andamento.
Canais de atendimento

Desconectar e reconectar um canal social

Interrompa uma conexão com confirmação explícita e preserve o histórico.

Onde encontrarIntegrações → WhatsApp / Instagram / Messenger → Conexão

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira o canal e os ativos conectados.
  2. Planeje com a equipe como tratar novas solicitações durante a interrupção.
  3. Clique em Desconectar e leia o diálogo.
  4. Use Confirmar desconexão somente para o canal correto.
  5. Confira o estado desconectado.
  6. Para retomar, utilize o assistente de conexão e confira o ativo selecionado antes de ativar.

Resultado esperado

O canal deixa de enviar e receber novas mensagens pelo Omnichannel até ser reconectado.

Observações importantes

  • O histórico dos atendimentos é mantido.
  • Desconectar é uma ação operacional, não uma forma de apagar clientes.
  • Uma configuração alterada por outro administrador pode exigir atualizar a tela antes de confirmar.
  • Se houver vários números do WhatsApp, a desconexão deve ser feita pelo cartão do número desejado. Confira a identificação antes de confirmar.

Se precisar de ajuda

  • Erro de revisão/configuração: atualize o estado e confira se outra pessoa modificou a conexão.
  • Para falha temporária, consulte o diagnóstico antes de desconectar.
Canais de atendimento

Gerenciar vários números do WhatsApp

Escolha o número correto antes de conectar, configurar ou desconectar um canal.

Onde encontrarConfigurações → Integrações → cartões WhatsApp

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Integrações e confira os cartões individuais com nome, número e situação da conexão.
  2. Para gerenciar uma conta, abra o cartão do número pretendido e confirme sua identificação na configuração.
  3. Para acrescentar outro número, use a opção de adicionar uma conexão e escolha login oficial da Meta ou configuração manual, quando disponíveis.
  4. No login da Meta, selecione os ativos autorizados da empresa e confira o número retornado antes de ativar.
  5. Configure fluxo de entrada, preferências, perfil e modelos no contexto do número selecionado.
  6. Antes de desconectar, confira novamente o número e o aviso da operação. Depois, verifique o status daquele cartão.

Resultado esperado

Cada número tem identificação e configuração próprias, sem substituir automaticamente os demais canais.

Observações importantes

  • Os cartões por número dependem de versão e licença; estão documentados na linha comercial 1.0.53 e posteriores.
  • Adicionar um canal não cria permissões sobre números de outras empresas nem migra por conta própria um serviço já utilizado em outro sistema.
  • Configurações e operações usam o canal selecionado. Modelos também dependem da conta WhatsApp Business e dos acessos liberados na Meta.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Número ausente: confira autorização sobre o ativo e a situação da conexão.
  • Conta diferente da esperada: feche o formulário e escolha o cartão correto antes de salvar.
Canais de atendimento

Distinguir menções e respostas a stories

Entenda por que uma marcação isolada não deve iniciar o mesmo atendimento de uma mensagem do cliente.

Onde encontrarInstagram → atendimento e fluxo de entrada do canal

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Na conversa, confira se o evento é uma menção em story, uma resposta ao story ou uma publicação compartilhada.
  2. Para menção isolada, confira o fluxo de entrada configurado. A rotina específica pode encerrar o evento sem mensagem nem pesquisa.
  3. Para uma resposta com solicitação ou uma conversa já em andamento, acompanhe a continuidade normal do atendimento.
  4. Se a classificação não corresponder ao conteúdo recebido, reúna o horário, o canal e a descrição do evento para o suporte.

Resultado esperado

A equipe distingue uma marcação isolada de um pedido que precisa de resposta.

Observações importantes

  • O tratamento específico foi incluído na versão comercial 1.0.56 e depende do fluxo configurado.
  • A disponibilidade de imagem e link depende do conteúdo e dos dados entregues pelo Instagram.
  • Uma menção não deve ser tratada automaticamente como autorização para outras ações sobre o cadastro do cliente.

Se precisar de ajuda

  • Resposta legítima encerrada: confira se o fluxo recebeu o tipo de evento correto antes de alterar toda a entrada do Instagram.
Canais de atendimento

Filtrar modelos WhatsApp por formato

Localize texto, mídia, botões e cobrança, distinguindo formato da mensagem, aprovação da Meta e compatibilidade de envio.

Onde encontrarConfigurações → Integrações → número do WhatsApp → Modelos de mensagem

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Gerenciar número no cartão do WhatsApp desejado e entre em Modelos de mensagem.
  2. Atualize os modelos quando necessário e confira a coluna Formato.
  3. Escolha Todos os formatos ou filtre por Texto, Imagem, Vídeo, Documento, Texto com botões, Cobrança com Pix/PDF, Carrossel ou Outro formato.
  4. Combine o filtro com a busca. A contagem ao lado informa quantos modelos correspondem aos critérios entre os modelos carregados.
  5. Confira Situação, Categoria, idioma e texto da mensagem. Aprovado pela Meta é uma situação de análise, não uma garantia de que qualquer tela consegue enviar aquele formato.
  6. Use Acesso para revisar os departamentos autorizados. Antes de enviar, confira se o formulário de abertura de chamado ou a integração correspondente oferece aquele modelo.

Resultado esperado

Você encontra o modelo certo sem confundir categoria de cobrança, formato e capacidade de envio.

Observações importantes

  • A coluna e o filtro de formato são documentados no pacote comercial 1.0.61-pilot, conforme a versão instalada.
  • Categoria e formato são distintos: Utilidade, Marketing e Autenticação indicam a categoria; Texto, Imagem e outros rótulos descrevem a estrutura.
  • Carrossel pode ser reconhecido na lista, mas exibe Envio ainda indisponível. Esse reconhecimento não habilita sua criação nem envio no Omnichannel.
  • Cobrança com Pix/PDF identifica um modelo de pagamento. Sua utilização depende da integração de cobrança compatível; não equivale a um HSM de texto comum.
  • O formato é identificado pelos componentes retornados pela Meta. Componentes não reconhecidos aparecem como Outro formato, sem inventar suporte.
  • Um modelo pode estar aprovado e restrito a departamentos, ou ter um formato indisponível na operação desejada.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Nenhum resultado: limpe a busca e selecione Todos os formatos.
  • Modelo aprovado ausente no envio: confira número de origem, idioma, acesso por setor e formato aceito pela operação.
  • Prévia de texto indisponível: alguns formatos não oferecem um corpo de texto simples para a listagem.
Canais de atendimento

Publicar uma central de ajuda para os clientes

Disponibilize orientações públicas no domínio da empresa e na busca do chat do site.

Onde encontrarConfigurações → Central de ajuda

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Com uma conta administrativa, abra Central de ajuda e confira o endereço público mostrado na tela.
  2. Defina título, apresentação e cor principal. Marque Disponibilizar central de ajuda aos clientes quando quiser abrir o portal e use Salvar portal.
  3. Use Novo artigo, informe título e categoria e escreva o conteúdo com parágrafos.
  4. Confira a Prévia do artigo. Para revisar antes de divulgar, salve sem publicação.
  5. Quando o conteúdo estiver aprovado, marque Artigo ativo e Publicar este conteúdo para os clientes e use Salvar e publicar.
  6. Abra o endereço público e teste a busca e a leitura do artigo. O chat do site também pode apresentar a busca quando a central estiver habilitada.
  7. Para retirar uma orientação, edite o artigo, desmarque sua publicação ou ativação e salve. Confira a retirada no portal.

Resultado esperado

Clientes acessam os artigos ativos e publicados da central habilitada.

Observações importantes

  • Requer o módulo de central de ajuda liberado na licença e administração para editar o portal e os artigos.
  • A central da empresa contém orientações ao cliente. Ela é diferente desta Wiki do produto e da base interna de conhecimento da equipe e da IA.
  • O conteúdo publicado é público. Não inclua dados de clientes, atendimentos reais, credenciais ou procedimentos internos restritos.
  • O editor usa texto com parágrafos. HTML digitado aparece como texto; não é uma forma de inserir comandos ou páginas executáveis.
  • O artigo precisa estar ativo e publicado, e o portal habilitado. Desabilitar o portal não apaga o conteúdo cadastrado.
  • Se outra pessoa editar o mesmo artigo, atualize a versão antes de salvar novamente para não sobrescrever a revisão concorrente.

Se precisar de ajuda

  • Artigo não aparece: confira publicação, ativação, portal habilitado e licença.
  • Conflito de versão: reabra o artigo, compare as alterações e reaplique somente a edição necessária.
  • Busca do chat ausente: confira a central e o widget da instalação; publicar esta Wiki não ativa o chat do site.
Canais de atendimento

Entender conteúdo não disponibilizado pelo WhatsApp

Saiba o que significa o aviso na conversa e como orientar o cliente quando for necessário.

Onde encontrarAtendimento WhatsApp → histórico da conversa

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Leia o aviso: o WhatsApp não disponibilizou o conteúdo daquela mensagem para a integração.
  2. Confira o horário e o contexto das mensagens próximas. O aviso não identifica qual era o conteúdo original.
  3. Se o conteúdo for necessário para resolver o pedido, solicite ao cliente que reenvie em um formato compatível.
  4. Continue a conversa normalmente quando chegar uma mensagem válida.

Resultado esperado

O atendente entende a limitação e decide se precisa pedir reenvio.

Observações importantes

  • Na versão 1.0.66-pilot, o termo técnico unsupported passa a ter uma explicação legível para o atendente, inclusive ao consultar eventos antigos compatíveis.
  • Esse evento não faz a IA responder, iniciar digitação ou avançar o fluxo automaticamente. A orientação de reenvio não é enviada sozinha ao cliente.
  • Não é possível concluir pelo aviso se o conteúdo era uma imagem, áudio ou mensagem apagada.

Se precisar de ajuda

  • Se recorrente, informe ao suporte o canal, o horário e o protocolo, sem anexar credenciais.
  • Uma imagem ou mensagem recebida depois pode ser outro envio; não presuma que ela substitui o conteúdo ausente.
Inteligência artificial

Configurar provedores de inteligência artificial

Defina chaves, modelos, prioridade e tempo limite para as APIs de IA autorizadas.

Onde encontrarConfigurações → Integrações → Inteligência artificial

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Chave da APICredencial do fornecedor. Em branco mantém a chave já cadastrada; não é a senha de acesso ao site.
Identificador do modeloNome técnico aceito pela API. Não é o nome dado à chave.
Ativo e PrioridadeIncluem o provedor na sequência de texto e definem Principal/Backups.
Habilitar sequência de IAControle geral da sequência de respostas de texto.
Tempo máximo / Limite totalPrazo por provedor e prazo total das tentativas, conforme limites do formulário.
Remover chave ao salvarRemove a credencial do cartão quando permitido. Não use esse comando para apenas trocar a prioridade.

Passo a passo

  1. Confira quais provedores aparecem na instalação. A lista depende dos recursos liberados pela licença.
  2. Use os guias relacionados e a seção Acessos externos para obter a chave da empresa. No cartão do provedor, preencha Chave da API e Identificador do modelo. FSNET IA tem modelo definido no servidor; FSNET IA e Hermes também oferecem configuração de URL.
  3. Use Salvar configuração antes de executar Testar conexão no cartão. Se a chave já estiver cadastrada, deixar seu campo em branco mantém a credencial atual.
  4. Marque Ativo nos provedores de texto que deseja usar e organize a prioridade como Principal, Backup 1 e seguintes.
  5. Confira Habilitar sequência de IA, o tempo máximo de cada API e o Limite total de espera. O limite total inclui as tentativas da sequência.
  6. Salve novamente e use Testar sequência. Confira o provedor que concluiu o teste e os resultados das tentativas anteriores.
  7. Revise separadamente Transcrição de áudio e Interpretação de imagens. Depois, homologue o agente e o fluxo com dados fictícios antes de depender da configuração no atendimento.

Resultado esperado

A IA usa os provedores habilitados conforme prioridade, disponibilidade e configuração.

Observações importantes

  • A lista pode incluir FSNET IA, OpenAI, Gemini, Grok, Claude, DeepSeek, Groq, Mistral, OpenRouter e Hermes; a disponibilidade depende da licença.
  • Testes podem gerar consumo no fornecedor.
  • Uma credencial de Manus é para integração de tarefas assíncronas; ela não integra automaticamente a sequência de respostas ao cliente.
  • Valores de franquia e modelo dependem do contrato e da instalação.
  • A prioridade dos provedores de texto não controla automaticamente a transcrição de áudio. Confira a configuração separada de áudio e imagens.
  • OpenAI, Gemini e Claude têm guias próprios nesta Wiki com atalhos para chaves e consumo. O fornecedor pode solicitar login, seleção da organização ou do projeto.
  • Uma chave cadastrada não significa que o provedor esteja ativo ou definido como principal. Confira os controles e a confirmação do salvamento.

Se precisar de ajuda

  • Chave inválida: confira conta, serviço e permissões da credencial.
  • Modelo inexistente: use um identificador aceito pelo seu provedor.
  • Teste desabilitado: salve as alterações pendentes e confira os campos obrigatórios.
Inteligência artificial

Configurar transcrição e interpretação de imagens

Escolha como o sistema auxilia a equipe ao receber áudios, fotos e comprovantes.

Onde encontrarConfigurações → Integrações → Inteligência artificial → Transcrição de áudio / Interpretação de imagens

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a integração de Inteligência artificial e confira os recursos da licença. A seção de transcrição exige IA e FSNET IA liberadas.
  2. Em Quem transcreve os áudios, escolha FSNET API — principal ou Desativada. Para transcrever, confira a chave e a URL do cartão FSNET IA, mesmo que ele esteja fora da sequência de texto.
  3. Ajuste Tempo máximo da transcrição no intervalo permitido pelo formulário.
  4. Em Quem analisa as imagens, escolha FSNET API — imagens locais, Sequência de provedores de IA ou Desativada. As opções disponíveis dependem da licença.
  5. Se escolheu FSNET API, confira a credencial e o tempo máximo da imagem. Se escolheu a sequência, confira provedores de imagem compatíveis ativos, com chave e modelo válido.
  6. Use Salvar configuração e reabra a tela para conferir as seleções. O teste de conexão textual não substitui a validação de áudio e imagem.
  7. Homologue com um áudio e uma imagem fictícios em ambiente de teste autorizado. Compare o texto reconhecido com o arquivo original e confira o comportamento quando a análise falha.

Resultado esperado

Áudios e imagens recebidos podem gerar informação complementar para o agente e a equipe.

Observações importantes

  • Na versão documentada, a transcrição usa FSNET IA ou fica desativada. Ela não muda automaticamente para GPT quando há falha.
  • A chave e a URL do cartão FSNET IA podem ser usadas para mídia mesmo quando ele está desativado nas respostas de texto.
  • A opção Sequência de provedores de IA para imagens considera os conectores compatíveis implementados: OpenAI, Gemini e FSNET IA. Outros provedores de texto não entram automaticamente nessa análise.
  • Áudio, imagens e respostas de texto são escolhas independentes. Alterar Principal ou Backup no texto não altera sozinho quem transcreve o áudio.
  • As condições de consumo dependem do serviço contratado. A franquia de texto da gerência não deve ser tratada como franquia de áudio ou imagens.
  • Interpretações podem falhar. O arquivo original continua sendo a referência; uma imagem de comprovante sozinha não comprova a baixa no sistema financeiro.

Se precisar de ajuda

  • Sem análise: confira configuração, licença, tamanho/formato e resultado do provedor.
  • Leitura incorreta: use revisão humana e não execute ações financeiras só pela imagem.
Inteligência artificial

Criar e configurar um agente virtual

Defina função, conhecimento, ferramentas e comportamento de um agente.

Onde encontrarAdministração → Agentes virtuais → Adicionar novo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Crie ou escolha um fluxo publicado e ativo. Nas versões com a ação de ativação, veja o estado ao lado do nome e use Atualizar fluxos para consultar a lista novamente.
  2. Clique em Adicionar novo e preencha nome, função/persona e instruções do agente.
  3. Selecione o fluxo inicial e o departamento quando houver destino fixo.
  4. Se o fluxo estiver publicado, porém inativo, use Ativar fluxo publicado quando disponível. Se não estiver publicado, publique uma versão no editor e atualize a lista.
  5. Preencha a base de conhecimento e habilite somente as ferramentas necessárias à função.
  6. Defina confiança mínima e mensagem para quando o agente não souber responder.
  7. Configure a ação e o prazo de inatividade, considerando a política geral da empresa.
  8. Salve e ative o agente.
  9. Homologue uma solicitação compreendida, uma ambígua e uma transferência para a equipe.

Resultado esperado

O agente pode ser utilizado nos fluxos autorizados com sua persona e regras.

Observações importantes

  • Agentes ativos atendem 24x7; períodos e feriados regulam a equipe humana.
  • Política global de inatividade pode ter prioridade sobre a regra individual.
  • O token interno do agente é uma credencial e deve ser protegido.
  • Ativar o fluxo não ativa o agente automaticamente. Revise o cadastro e salve/ative o agente em sua própria configuração.
  • Na versão 1.0.67-pilot, a primeira resposta automática apresenta a Mary com o nome do cadastro da empresa da própria instalação e a saudação conforme o horário. A apresentação não se repete nas mensagens seguintes. O nome do produto e a razão social não substituem o nome da empresa nessa apresentação.

Se precisar de ajuda

  • Não foi possível ativar: confirme fluxo ativo e publicado.
  • Respostas inadequadas: revise instruções, conhecimento e ferramentas; confira também o provedor.
Inteligência artificial

Cadastrar intenções e ações autorizadas

Ensine como reconhecer o pedido, escolher o setor e limitar o autoatendimento.

Onde encontrarAdministração → Intenções

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Clique em Nova intenção.
  2. Informe nome e descrição que diferenciem esse pedido dos demais.
  3. Selecione o setor de encaminhamento quando aplicável.
  4. Escolha a ação automática IXC permitida ou Nenhuma.
  5. Defina a confiança mínima e cadastre frases variadas de exemplo.
  6. Ative a intenção e salve a base.
  7. Teste pedidos claros e ambíguos no fluxo e confira se setor e ação são os esperados.
  8. Use filtros de ativas/inativas para revisar o catálogo e remova apenas itens que não devem mais ser utilizados.

Resultado esperado

O catálogo orienta a classificação e as ações autorizadas do fluxo.

Observações importantes

  • O identificador é fixo para preservar histórico e referências.
  • A IA não ganha permissão para uma ação só porque reconheceu uma frase.
  • Catálogo vazio não classifica novos pedidos por intenções cadastradas.

Se precisar de ajuda

  • Intenções confundidas: revise descrições e exemplos sobrepostos.
  • Ação não executada: confira confiança, habilitação, identificação do cliente e configuração do fluxo.
Inteligência artificial

Revisar aprendizado e exemplos históricos

Aproveite frases dos atendimentos com controle sobre o catálogo de intenções.

Onde encontrarAdministração → Intenções → Aprendizado com os atendimentos

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Escolha Desativado, Automático quando compatível com o fluxo ou Revisar antes de usar.
  2. Salve a base para aplicar a escolha.
  3. Abra os exemplos coletados e confira a intenção, a frase e o motivo da revisão.
  4. Use Aprovar e usar somente quando o exemplo representar a intenção correta.
  5. Use Rejeitar ou Remover da base para descartar um exemplo inadequado.
  6. Na área de histórico Opa, quando houver uma importação disponível, escolha a intenção de destino, confira os exemplos anonimizados e aprove ou rejeite.

Resultado esperado

Exemplos aprovados complementam as intenções existentes sem mudar seus setores e ações por conta própria.

Observações importantes

  • A inclusão automática exige confiança de pelo menos 95%, intenção única e compatibilidade com setor e ação validados pelo fluxo.
  • Casos ambíguos aguardam revisão.
  • Importar histórico é uma preparação técnica separada; esta tela revisa os candidatos disponibilizados.

Se precisar de ajuda

  • Ações de revisão desabilitadas: salve ou descarte alterações pendentes.
  • Sem exemplos: confira o modo ativo e a existência de novas classificações elegíveis.
Inteligência artificial

Cadastrar conhecimento e procedimentos

Mantenha orientações aprovadas, com versão e validade, para a operação e a IA.

Onde encontrarAdministração → Operação inteligente → Conhecimento e procedimentos

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Conhecimento e procedimentos e crie um registro.
  2. Preencha título, assunto, versão e palavras-chave.
  3. Escreva o conteúdo e explique quando usar, dados necessários, ações permitidas e regras de transferência.
  4. Defina vigência e registre as mudanças desta versão.
  5. Salve como rascunho para revisão ou aprove quando o conteúdo tiver sido conferido pelo responsável.
  6. Use a busca para conferir como o procedimento é localizado.
  7. Ao substituir uma orientação, revise a versão e arquive o conteúdo que deixou de valer.

Resultado esperado

A operação dispõe de conteúdo organizado e aprovado para consulta.

Observações importantes

  • Não inclua chaves, tokens ou senhas na base.
  • Um procedimento deve descrever o que realmente está autorizado e disponível.
  • A aprovação do conteúdo não configura automaticamente uma integração externa.

Se precisar de ajuda

  • Conteúdo não encontrado: confira palavras-chave, aprovação e vigência.
  • Edição concorrente: atualize o registro e reaplique apenas a alteração pretendida.
Inteligência artificial

OpenAI: criar a chave, conectar e acompanhar o consumo

Acesse diretamente os painéis da OpenAI e cadastre uma chave de API na instalação correta.

Onde encontrarOpenAI Platform; Configurações → Integrações → Inteligência artificial → OpenAI

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Tenha acesso à organização/projeto OpenAI e permissão para configurar a IA no Omnichannel. O provedor deve estar liberado na licença.

Passo a passo

  1. Abra Criar chave OpenAI acima e entre com a conta autorizada da empresa. Confira a organização e o projeto selecionados.
  2. Crie uma nova chave de API com as permissões necessárias ao modelo utilizado e dê um nome que identifique a instalação.
  3. Copie a chave completa no momento da criação e guarde-a em local protegido. Se perdeu uma chave antiga, crie uma substituta: o painel não recupera o valor completo.
  4. No Omnichannel, abra a integração de Inteligência artificial e o cartão OpenAI. Cole a chave em Chave da API e preencha Identificador do modelo com um modelo disponível na conta.
  5. Use Salvar configuração e depois Testar conexão no cartão. Leia o resultado antes de alterar a prioridade usada nos atendimentos.
  6. Para utilizar o provedor nas respostas, confira Ativo, a posição Principal ou Backup e Habilitar sequência de IA. Salve novamente e use Testar sequência.
  7. Acompanhe Consumo, Faturamento e Limites pelos botões acima. Se substituiu uma chave, revogue a antiga somente depois de validar a nova e conferir quais outros sistemas a utilizam.

Resultado esperado

Chave cadastrada e teste de conexão conferido, com acesso direto ao acompanhamento do provedor.

Observações importantes

  • A integração do Omnichannel usa uma chave da API OpenAI. A assinatura do ChatGPT e o consumo da API são separados; não cole sua senha do ChatGPT nesse campo.
  • Chave da API, nome que você deu à chave e identificador do modelo são informações diferentes.
  • Quando a tela mostra Chave da API · cadastrada, deixar o campo em branco mantém a credencial existente. A tela não exibe a chave completa.
  • O teste pode consumir recursos e gerar cobrança no fornecedor. Um teste de conexão não valida sozinho o comportamento de todos os fluxos.
  • Os botões abrem sites oficiais e podem solicitar login. A visualização de faturamento e limites depende das permissões da conta.

Se precisar de ajuda

  • Chave recusada: confira projeto, permissões e validade; copie novamente sem espaços extras.
  • Modelo recusado: confira o identificador e a disponibilidade na API dessa conta.
  • Teste desabilitado: salve as alterações e confira se chave e modelo foram preenchidos.
  • Cota ou saldo insuficiente: confira o painel da API antes de criar outra chave. Outra chave do mesmo projeto não resolve a falta de cota.

Referências oficiais

Inteligência artificial

Gemini: criar a chave e conectar o Google AI Studio

Escolha o projeto Google, obtenha a chave e confira o teste no Omnichannel.

Onde encontrarGoogle AI Studio; Configurações → Integrações → Inteligência artificial → Gemini

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Tenha acesso ao projeto Google e à configuração de IA; Gemini precisa estar liberado na licença da instalação.

Passo a passo

  1. Abra Criar chave Gemini acima e entre na conta Google autorizada da empresa.
  2. Confira o projeto associado à chave. Se um projeto existente não aparecer, importe-o no AI Studio ou peça ao administrador o acesso necessário.
  3. Use a opção de criar chave de API no projeto desejado. Copie e guarde a credencial em local protegido.
  4. No cartão Gemini do Omnichannel, cole a credencial em Chave da API. Em Identificador do modelo, informe um modelo disponível na Gemini API da sua conta; não use o nome que deu à chave.
  5. Use Salvar configuração e Testar conexão. Se o teste passar, confira Ativo, Principal ou Backup e Habilitar sequência de IA; salve e teste a sequência.
  6. Abra Consultar consumo Gemini para acompanhar o projeto e Faturamento Gemini para conferir sua situação. Ao substituir uma chave, valide a nova antes de revogar a anterior.

Resultado esperado

O projeto e a chave corretos ficam associados à configuração testada do Gemini.

Observações importantes

  • Cada chave está associada a um projeto Google. As permissões, os limites e o faturamento dependem desse projeto e da conta.
  • Os botões oficiais podem pedir login ou seleção de projeto. A documentação do Google também orienta o acesso ao consumo por Dashboard → Usage.
  • Não há garantia de gratuidade ou disponibilidade de um modelo apenas porque a chave foi criada. Confira as condições atuais do projeto.
  • A escolha de Gemini para texto não muda automaticamente a transcrição de áudio. Imagens têm configuração própria no Omnichannel.

Se precisar de ajuda

  • Projeto ausente: confira a conta Google, a importação e as permissões do projeto.
  • Criação de chave indisponível: solicite ao administrador as permissões exigidas pelo AI Studio.
  • Falha no teste: confira chave, acesso ao modelo, cotas e situação de faturamento; salve alterações antes de testar novamente.

Referências oficiais

Inteligência artificial

Claude: criar a chave Anthropic e acompanhar o consumo

Use o console oficial da Claude Platform para obter a chave utilizada pelo Omnichannel.

Onde encontrarClaude Platform; Configurações → Integrações → Inteligência artificial → Anthropic Claude

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Tenha uma conta autorizada no console Anthropic/Claude e o provedor liberado na licença do Omnichannel.

Passo a passo

  1. Abra Criar chave Claude acima e entre no console da empresa. Confira a organização e o workspace selecionados.
  2. Crie a chave, informe um nome que identifique a integração e confira a validade. Para uma integração compartilhada, siga a orientação do administrador sobre a conta de serviço.
  3. Copie a chave completa quando ela for apresentada e guarde-a em local protegido. A Claude Platform só a exibe integralmente na criação.
  4. No Omnichannel, localize o cartão Anthropic Claude, cole a chave e informe o identificador de um modelo autorizado na conta.
  5. Use Salvar configuração e Testar conexão. Depois, confira Ativo, a prioridade e Habilitar sequência de IA; salve e teste a sequência.
  6. Acompanhe o uso e os custos pelos botões acima. Se a chave foi substituída, valide a nova antes de retirar a antiga dos sistemas que ainda a utilizam.

Resultado esperado

Claude configurado e testado como provedor de texto disponível para a sequência da instalação.

Observações importantes

  • O endereço atual de gerenciamento de chaves é platform.claude.com/settings/keys. Os painéis podem solicitar login e dependem das permissões da organização.
  • A credencial deve pertencer à empresa e ao workspace correto; não utilize uma chave administrativa de relatórios como substituta da chave de inferência.
  • Na implementação documentada, Claude participa das respostas de texto. A sequência de análise de imagens do Omnichannel usa somente os provedores compatíveis implementados; habilitar Claude não o inclui nessa análise.
  • Não é necessário preencher uma URL alternativa de API no cartão Claude. O endereço do serviço é definido pelo conector.

Se precisar de ajuda

  • Chave perdida: crie outra; o console não recupera o valor completo.
  • Botão de criar chave indisponível: peça ao administrador a permissão ou uma credencial adequada à integração.
  • Falha no teste: confira a chave, o modelo, sua validade e a situação de consumo do workspace.

Referências oficiais

Fluxos e automação

Criar um fluxo no construtor visual

Aprenda a montar blocos e conexões e acompanhe um exemplo completo com imagens, campos preenchidos e testes.

Onde encontrarAdministração → Fluxos de atendimento → Novo fluxo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Clique em Novo fluxo e dê um nome claro. O bloco Início já é criado pelo editor.
  2. Adicione os blocos pela biblioteca. Clique em cada um para configurar seus campos; os IDs visuais são gerados pelo editor.
  3. Use Nova conexão para selecionar origem, saída e destino. Em condições, confira as duas saídas, Sim e Não.
  4. Adicione Fim do fluxo automático e confira se todos os blocos são alcançáveis desde o Início. Esse Fim não encerra o atendimento do cliente.
  5. Use Ver todo para conferir o desenho. Clique em Testar rascunho e execute a validação gráfica.
  6. Depois de validar a revisão atual, use Salvar rascunho. Corrigiu algum campo? Teste novamente antes de salvar.
  7. Teste a versão salva e confira o comportamento no simulador. Publique e aplique ao canal conforme o guia ilustrado.

Resultado esperado

O rascunho do fluxo é salvo com os blocos e conexões configurados.

Observações importantes

  • Salvar rascunho não publica a versão.
  • Nem todos os blocos do editor possuem executor operacional na base consultada; leia a referência de cada um.
  • Evite ciclos sem condição de saída.

Se precisar de ajuda

  • Erro ao salvar: procure IDs duplicados, conexões para blocos inexistentes ou departamento inativo.
  • Caminho incompleto: confira saídas e o destino de cada conexão.
Fluxos e automação

Criar um fluxo do zero: exemplo com imagens

Construa uma triagem com IA em seis blocos. Veja o desenho, preencha cada campo, conecte as saídas e teste até publicar.

Onde encontrarAdministração → Fluxos de atendimento → Novo fluxo

Antes de começar

  • Entre como administrador autorizado a configurar fluxos.
  • Tenha dois departamentos ativos: Financeiro e um setor de atendimento geral, com equipe vinculada e horário geral configurado.
  • Confira módulo/licença de IA, provedor habilitado e catálogo de intenções. Para o exemplo, a classificação financeira deve retornar ia_setor = Financeiro.
  • Use mensagens fictícias no simulador. Não envie mensagens a clientes para testar infraestrutura.

Passo a passo

  1. Prepare dois departamentos ativos e confira a configuração de IA da empresa.
  2. Monte os seis blocos e as seis conexões seguindo o passo a passo ilustrado abaixo.
  3. Teste o rascunho, salve, teste a versão salva e publique.
  4. Selecione a versão publicada no fluxo de entrada de um canal autorizado.
EXEMPLO PARA REPRODUZIR

Uma mensagem, uma decisão, o setor certo.

O cliente escreve com suas palavras. O fluxo identifica o assunto e encaminha a conversa à equipe. Acompanhe o desenho e monte cada etapa no seu painel.

Imagens ilustrativas do editor, com dados fictícios. Elas explicam os campos e não representam uma captura da sua instalação.

Mapa com Início, Identificar intenção, condição ia_setor igual a Financeiro, duas transferências e Fim. Sim segue ao Financeiro; Não segue ao Atendimento geral.
Mapa completo do exemplo. As duas saídas terminam em atendimento humano. As linhas tracejadas mostram a ligação estrutural ao Fim. Ampliar imagem ↗

Abra um fluxo novo e reconheça as três áreas do editor

Clique em Novo fluxo e troque o nome para Exemplo · Triagem com IA. Mantenha o cadastro ativo para a etapa de aplicação, depois da publicação.

O bloco Início já aparece. A biblioteca fica à esquerda; o desenho, no centro; os campos do bloco selecionado, à direita.

Adicione, nesta ordem: Identificar intenção, Condicional, Transferir atendimento duas vezes e Fim do fluxo automático. Você terá seis blocos contando o Início.

Arraste os cartões para organizar o desenho. Use Ver todo para ajustar o zoom. Arrastar e aproximar cartões não cria conexões.

Editor ilustrado com biblioteca de blocos à esquerda, desenho ao centro e configuração à direita.
Crie primeiro os blocos. Depois configure os campos e conecte o caminho. Ampliar imagem ↗

Configure B02 para ler a mensagem inicial

Clique em Identificar intenção e preencha Nome com Ler o pedido. Mantenha Confiança mínima em 0,75, valor inicial do exemplo.

Esse bloco usa a mensagem do cliente disponível na execução e produz informações como ia_intencao, ia_setor e ia_resumo.

Não adicione uma pergunta obrigatória “qual o motivo?” antes dele: a mensagem “Preciso da segunda via do boleto” já informa o pedido.

Identificar intenção classifica; Conversar com agente de IA é outro bloco, usado para diálogo. Este exemplo encaminha o resultado da classificação diretamente à equipe.

Preencha assim
CampoValor do exemplo
NomeLer o pedido
Confiança mínima0,75 (ou 0.75, conforme o navegador)
Resultado usado na próxima etapaia_setor
Configuração de Identificar intenção: Nome Ler o pedido, Confiança mínima 0,75 e resultado ilustrativo ia_setor Financeiro.
O resultado exibido é um exemplo. Confira a classificação real no teste da sua instalação. Ampliar imagem ↗

Configure B03 para decidir o destino

Selecione Condicional e preencha os campos exatamente como na tabela.

Use ia_setor sem chaves no campo Variável. O texto Financeiro deve corresponder ao valor retornado pela classificação.

Quando a comparação for verdadeira, o caminho será Sim. Qualquer valor diferente seguirá por Não para a equipe geral.

Preencha assim
CampoValor do exemplo
NomeÉ financeiro?
Variávelia_setor
OperadorIgual a
ValorFinanceiro
Painel de Condicional preenchido com Nome É financeiro?, Variável ia_setor, Operador Igual a e Valor Financeiro.
Variável é o dado consultado; operador é a comparação; valor é o resultado esperado. Ampliar imagem ↗

Escolha os dois departamentos de transferência

No primeiro Transferir atendimento, preencha Nome com Financeiro e selecione o departamento Financeiro da sua empresa.

No segundo, preencha Nome com Atendimento geral e selecione o setor responsável por recepção ou suporte. Não basta digitar o nome: escolha o departamento no seletor.

No bloco Fim do fluxo automático, mantenha um nome que deixe claro que ele finaliza somente a automação.

O motor aplica as regras de distribuição e o horário geral quando transfere. O histórico da conversa permanece disponível à equipe.

Preencha assim
CampoValor do exemplo
B04 · Nome / DepartamentoFinanceiro / selecione seu setor financeiro
B05 · Nome / DepartamentoAtendimento geral / selecione seu setor de recepção ou suporte
B06 · NomeFim do fluxo automático
Dois painéis de transferência: Financeiro selecionado no B04 e Atendimento geral selecionado no B05.
Os departamentos selecionados precisam existir e estar ativos na sua operação. Ampliar imagem ↗

Crie as seis conexões e confira Sim e Não

Clique em Nova conexão na biblioteca. No painel da ligação, escolha Bloco de origem, Tipo de saída e Bloco de destino.

Siga a tabela na ordem apresentada. Para a condição, crie Não primeiro: Nova conexão começa com Sim e pode substituir uma ligação Sim já existente. Depois adicione a saída Sim.

Confira que saem duas linhas de B03: Sim para B04 e Não para B05. Todos os demais blocos, exceto Fim, têm uma saída Próximo.

Ligue as duas transferências ao mesmo Fim para completar a estrutura exigida pelo validador. Na execução, a transferência já pausa a automação; o cliente não é encerrado por essa linha.

Conexões, na ordem de criação
OrigemSaídaDestino
B01 · InícioPróximoB02 · Ler o pedido
B02 · Ler o pedidoPróximoB03 · É financeiro?
B03 · É financeiro?NãoB05 · Atendimento geral
B03 · É financeiro?SimB04 · Financeiro
B04 · FinanceiroPróximoB06 · Fim do fluxo automático
B05 · Atendimento geralPróximoB06 · Fim do fluxo automático
Nova conexão configurada com origem B03 É financeiro?, saída Não e destino B05 Atendimento geral.
As conexões controlam a execução. Posição no desenho é apenas organização visual. Ampliar imagem ↗

Valide a estrutura antes de salvar

Clique em Testar rascunho. Em Modo do teste, selecione Apenas validar graficamente (sem enviar) e clique em Executar teste.

Confira os seis blocos, as seis conexões e os dois caminhos. Corrija qualquer mensagem sobre início, fim, saída ausente, departamento ou bloco desconectado.

A validação gráfica percorre a estrutura sem executar IA, enviar mensagens ou fazer ações no IXC. Ela não confirma que uma frase será classificada corretamente.

Quando o teste da revisão atual estiver concluído, volte ao editor e clique em Salvar rascunho. Se alterar qualquer campo depois do teste, execute-o novamente.

Comparação entre validação gráfica, que confere a estrutura, e simulação de conversa, que confere o comportamento.
Use a validação para corrigir o desenho e a simulação para conferir a experiência. Ampliar imagem ↗

Simule os pedidos e confira o destino

Clique em Testar versão salva. Escolha Simular resposta em canal e selecione o tipo de canal utilizado na operação.

Na primeira mensagem, escreva “Preciso da segunda via do boleto” e clique em Iniciar conversa. Confira a classificação e a transferência para o Financeiro.

Use Reiniciar conversa e teste “Minha internet está lenta”. Para a classificação de suporte, o destino deste exemplo é Atendimento geral.

Reinicie e teste “Quero falar com uma pessoa”. A execução deve encaminhar a uma equipe humana sem obrigar o cliente a responder um menu.

Teste também uma saudação curta e um pedido ambíguo. Confira a saída realmente produzida; ajuste o catálogo ou a lógica se o resultado não atender sua operação.

O simulador do produto pode utilizar a IA configurada e gerar consumo no provedor. O fluxo de exemplo não contém consulta financeira nem ações no IXC. Se acrescentar esses blocos, revise os efeitos antes de testar.

O que conferir
  • Nenhum menu de números é exigido.
  • O pedido inicial aparece no histórico.
  • Financeiro segue por Sim; outros valores seguem por Não.
  • Pedido de pessoa termina em transferência humana.
  • Não é anunciado envio de boleto, pagamento ou desbloqueio.

Publique a versão que você acabou de testar

Volte ao editor e confira que não há alterações não salvas.

Se você corrigiu o desenho durante os testes, repita: Testar rascunho → Salvar rascunho → Testar versão salva.

Clique em Publicar e aguarde a confirmação da versão. Na biblioteca, confira o selo Publicado e o número da versão.

O botão pode ficar desabilitado se a revisão salva ainda não foi testada. Salvar rascunho, sozinho, não publica o fluxo.

Sequência em quatro etapas: Testar rascunho, Salvar rascunho, Testar versão salva e Publicar.
Os testes precisam corresponder ao conteúdo que será salvo e publicado. Ampliar imagem ↗

Aplique o fluxo ao canal escolhido

Abra Integrações e selecione o canal autorizado para usar o exemplo. No WhatsApp, localize Fluxo de entrada.

Escolha Exemplo · Triagem com IA e clique em Aplicar. Nos outros canais, confira o campo e o comando de salvar correspondentes.

Revise o nome do fluxo selecionado e a versão publicada antes de liberar o canal para a operação.

Acompanhe as primeiras conversas operacionais autorizadas e a fila dos setores. Não prometa atendimento imediato se a equipe estiver fora do horário.

Guarde a referência do fluxo anterior para uma eventual reversão. Trocar o fluxo de entrada pode afetar os próximos atendimentos do canal.

Seletor Fluxo de entrada com Exemplo Triagem com IA e botão Aplicar no canal WhatsApp.
Criar, publicar e aplicar são ações diferentes. O canal precisa apontar para o fluxo correto. Ampliar imagem ↗
VEJA A LÓGICA EM TRÊS SITUAÇÕES

Abra um exemplo e acompanhe o caminho

Demonstração ilustrativa com resultados descritos. Esta wiki não executa IA, consultas ao IXC ou envios de mensagens.

Pedido financeiro
MENSAGEM DO CLIENTE
Preciso da segunda via do boleto.

ia_setor: Financeiro

B01 → B02 → B03 · Sim → B04 · Financeiro

A conversa vai para o setor financeiro. O exemplo não emite nem envia boleto. O atendente continua com o pedido original no histórico.

Suporte ou outro assunto
MENSAGEM DO CLIENTE
Minha internet está lenta.

ia_setor: Suporte (exemplo de valor diferente de Financeiro)

B01 → B02 → B03 · Não → B05 · Atendimento geral

A equipe geral recebe a conversa. Nenhuma reinicialização, consulta de rede ou abertura de OS é executada por este desenho.

Quero uma pessoa
MENSAGEM DO CLIENTE
Quero falar com uma pessoa.

ia_setor: Valor retornado pelo classificador; confira no simulador

B01 → B02 → B03 → B04 ou B05 · equipe humana

Ambas as saídas são transferências humanas. O fluxo não impõe uma pergunta ou um menu como condição para chegar à equipe.

Leve o roteiro para montar no painel

Lista de blocos, valores, conexões e testes em um arquivo de texto. Este roteiro é para consulta; não é um arquivo de importação.

Baixar o roteiro de montagem (.txt)

Resultado esperado

Um fluxo que aproveita a primeira mensagem, identifica o assunto e encaminha a conversa ao Financeiro ou ao Atendimento geral, preservando o histórico.

Observações importantes

  • Este exemplo ensina triagem e transferência. Não consulta o IXC, não envia boleto, não desbloqueia contrato e não encerra o atendimento.
  • As imagens são ilustrações didáticas baseadas nos campos do editor consultado em 19/09/2026, com dados fictícios. Não são capturas da sua empresa.
  • O bloco Identificar intenção depende do módulo de IA habilitado e da configuração da instalação. O resultado pode variar com o catálogo de intenções e o provedor.
  • O campo Confiança mínima mantém o valor inicial do editor neste exemplo. Não o trate, sozinho, como garantia de bloqueio ou encaminhamento: confira o resultado real da classificação.
  • Os IDs B01 a B06 são gerados pelo editor. Se os seus forem diferentes, identifique os blocos pelo nome e ajuste a tabela de conexões.
  • A transferência pausa a automação e entrega a conversa à operação humana. A ligação ao Fim mantém o desenho completo para validação; não representa encerramento automático do chamado.
  • Publicar o desenho e aplicar o fluxo ao canal são duas etapas. Mudanças em um fluxo já usado por clientes exigem revisão do responsável pela operação.
  • Nas versões com horário geral (a partir de 0.45.5), as transferências seguem o calendário único da empresa. Referências a horários de setor em versões anteriores devem ser lidas como horário geral nas versões atuais.

Se precisar de ajuda

  • Salvar rascunho desabilitado: execute o teste da revisão atual antes de salvar. Qualquer alteração posterior exige novo teste.
  • Publicar desabilitado: salve, teste a versão salva e confira os avisos. Testar antes de salvar não libera sozinho a publicação.
  • Saída Sim desapareceu: Nova conexão começa com Sim em condições e pode substituir outra saída Sim. Crie a saída Não primeiro e confira ambas no final.
  • Pedido financeiro foi para atendimento geral: confira ia_setor retornado, catálogo de intenções, operador Igual a e valor Financeiro. Não troque a variável por ia_intencao sem revisar a lógica.
  • Departamento não encontrado: escolha um departamento ativo da sua empresa. O nome Atendimento geral é ilustrativo; pode ser seu setor de suporte ou recepção.
  • Ficou em fila: confira o horário geral, os usuários online e a distribuição do setor. Transferir não garante que haverá atendente disponível imediatamente.
Fluxos e automação

Testar, publicar e desfazer uma versão do fluxo

Valide o caminho e torne uma revisão disponível aos canais.

Onde encontrarFluxos de atendimento → Revisar e publicar

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra o fluxo em Editar ou Revisar e publicar e confira os blocos, as conexões e os departamentos.
  2. Se houver alterações não salvas, clique em Testar rascunho. Execute Apenas validar graficamente (sem enviar) e corrija os avisos.
  3. Salve a revisão testada pelo botão Salvar rascunho. Se alterar algo, repita o teste antes de salvar.
  4. Clique em Testar versão salva. Valide a estrutura e use Simular resposta em canal para conferir o comportamento com mensagens fictícias.
  5. No teste de conversa, confira a conclusão ou transferência, reinicie e percorra os outros cenários. O teste gráfico não comprova integrações nem classificação da IA.
  6. Volte ao editor sem alterações pendentes e clique em Publicar. Confira o número da versão e o selo Publicado.
  7. No canal, selecione o fluxo de entrada e use o comando de aplicar/salvar.
  8. Se necessário, use Desfazer versão na biblioteca para republicar a versão anterior disponível, e confira o resultado antes de continuar.

Resultado esperado

Uma versão publicada fica disponível ao roteamento; a versão anterior pode ser republicada pelo comando de desfazer.

Observações importantes

  • A validação gráfica confere estrutura e não comprova todas as integrações reais.
  • A simulação deve usar dados fictícios; não confunda o simulador com enviar mensagens a clientes para homologar.
  • Publicar não restaura banco nem apaga histórico.
  • Publicado e Ativo são estados diferentes. Nas versões a partir de 0.45.10, um fluxo publicado e inativo pode ser ativado diretamente na biblioteca; consulte Ativar um fluxo publicado.

Se precisar de ajuda

  • Publicação bloqueada: leia o erro e confira Início, conexões e referências.
  • Desfazer indisponível: pode não existir versão anterior.
Fluxos e automação

Importar, revisar e excluir fluxos

Use uma exportação compatível como ponto de partida e revise todos os avisos.

Onde encontrarAdministração → Fluxos de atendimento → Importar fluxo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Obtenha o JSON de fluxo compatível da origem autorizada.
  2. Clique em Importar fluxo e selecione o arquivo.
  3. Leia o resultado da importação e os avisos de revisão.
  4. Abra o fluxo e confira textos, variáveis, departamentos e referências a integrações.
  5. Troque referências da empresa de origem por dados da sua operação.
  6. Valide, salve e publique após revisar.
  7. Para remover um fluxo, confira antes quais canais, agentes e subfluxos o utilizam; use Excluir e confirme somente quando a remoção for apropriada.

Resultado esperado

O fluxo importado é revisado antes de ser utilizado na operação.

Observações importantes

  • Importação não significa equivalência funcional completa com o sistema de origem.
  • Excluir um fluxo não é o mesmo que desfazer sua última versão.

Se precisar de ajuda

  • Arquivo recusado: confira se é JSON compatível e leia o erro.
  • Referência quebrada: selecione setores, agentes e subfluxos existentes nesta instalação.
Fluxos e automação

Usar variáveis e condições no fluxo

Reutilize os dados coletados e conecte decisões ao resultado real das etapas.

Onde encontrarConstrutor visual → bloco → Inserir variável

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Selecione o bloco de mensagem, pergunta ou condição.
  2. Use Inserir variável para escolher uma variável conhecida pelo editor.
  3. Em perguntas, defina o nome da variável que receberá a resposta.
  4. Em mensagens, confira a forma {{nome_variavel}} e se um bloco anterior preenche esse valor.
  5. Em condições, selecione variável, operador e valor de comparação.
  6. Conecte as saídas Sim e Não. Se estiver consultando horário, confira o calendário geral de atendimento da empresa.
  7. Simule os dois caminhos, inclusive o caso em que o valor ainda não existe.

Resultado esperado

O fluxo usa valores do atendimento para personalizar mensagens e escolher caminhos.

Observações importantes

  • Variável visível no catálogo pode estar vazia naquele ponto do fluxo.
  • Exemplos: {{nome_empresa}}, {{nome_contato}}, {{protocolo}}, {{ia_intencao}}, {{cliente_id}} e {{pix_copia_cola}}.
  • Verificar horário não transfere por si só; conecte um bloco de transferência.

Se precisar de ajuda

  • Texto em branco: confirme quem gera a variável e a ordem das etapas.
  • Rota errada: revise operador, valor e conexão de saída.
Fluxos e automação

Entender quais blocos executam ações

Diferencie os recursos operacionais dos blocos que ainda precisam de um executor específico.

Onde encontrarConstrutor visual → biblioteca e resultado do teste

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Identifique a ação que o fluxo precisa realizar.
  2. Consulte o artigo de referência do bloco e sua indicação de disponibilidade.
  3. Para mensagem, pergunta, condição, intenção, agente, identificação IXC, operações IXC suportadas, etiqueta, espera, transferência e subfluxo, confira os pré-requisitos correspondentes.
  4. Para Abrir atendimento pelo WhatsApp, Conta, Desviar ligação, Marcar horário na agenda, Requisição HTTP, Template interativo e Enviar arquivo, trate o bloco como configuração que exige executor específico na base consultada.
  5. Use as ações próprias do painel quando disponíveis: abertura de chamado/HSM, anexos, OS e conectores.
  6. Confirme com o suporte qualquer diferença da versão instalada antes de publicar um caminho dependente desses blocos.

Resultado esperado

O fluxo publicado não depende de uma ação apenas desenhada no editor sem execução comprovada.

Observações importantes

  • Enviar notificação é tratado pelo motor consultado como texto no atendimento atual; os campos de canal e destinatário não comprovam disparo para SMS ou e-mail.
  • O bloco ERP possui operações específicas; opções genéricas sem executor não devem ser apresentadas como concluídas.
  • Fim do fluxo automático preserva a conversa.

Se precisar de ajuda

  • Aviso “requer um executor específico”: substitua o caminho por uma ação suportada ou encaminhe à equipe.
  • Estrutura aprovada não garante que uma ação externa foi executada.
Fluxos e automação

Bloco: Início

Define o ponto de entrada do fluxo.

Onde encontrarAdministração → Fluxos de atendimento → editor → Início

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
NomeIdentifique o ponto inicial, mantendo apenas um Início.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Início.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte a saída ao primeiro passo que deve executar.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

A execução encontra um ponto inicial único.

Observações importantes

  • Não use dois blocos Início no mesmo fluxo.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Enviar mensagem

Envia texto no atendimento atual.

Onde encontrarAdministração → Fluxos de atendimento → editor → Enviar mensagem

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
TextoEscreva a mensagem e insira variáveis somente quando já tiverem valor.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Enviar mensagem.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte ao próximo passo; use uma pergunta se precisar aguardar uma resposta.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O texto é encaminhado pelo canal da conversa.

Observações importantes

  • Mensagens de texto consecutivas não devem repetir saudações e instruções desnecessárias.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Enviar pergunta

Coleta a resposta do cliente em uma variável.

Onde encontrarAdministração → Fluxos de atendimento → editor → Enviar pergunta

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
TextoPergunta clara e objetiva.
VariávelNome que guardará a resposta.
TentativasQuantidade de tentativas disponibilizada no editor.
ValidaçãoSem validação, telefone com DDD ou resposta obrigatória, conforme a tarefa.
Salvar no contatoUse telefone informado ou endereço somente quando a pergunta coleta esse dado.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Enviar pergunta.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Defina a mensagem de resposta inválida e conecte os caminhos apresentados.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

A execução aguarda a resposta e disponibiliza o valor à próxima etapa.

Observações importantes

  • Não colete um documento quando o pedido ainda pode ser compreendido sem ele.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Solicitar descrição do atendimento

Coleta o motivo do contato para orientar as próximas etapas.

Onde encontrarAdministração → Fluxos de atendimento → editor → Solicitar descrição do atendimento

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
TextoExplique que o cliente pode descrever o problema.
VariávelUse o nome que será consultado nos passos seguintes.
TentativasLimite de repetição da pergunta.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Solicitar descrição do atendimento.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte à classificação ou encaminhamento que utiliza a descrição.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

A descrição do pedido fica registrada para o fluxo e para a equipe.

Observações importantes

  • Evite pedir novamente o motivo se o cliente já o informou.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Enviar pesquisa de satisfação

Solicita uma avaliação padronizada de 1 a 5.

Onde encontrarAdministração → Fluxos de atendimento → editor → Enviar pesquisa de satisfação

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
TextoUse a orientação compatível com a pesquisa padronizada.
VariávelNome para a avaliação quando oferecido pelo editor.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Enviar pesquisa de satisfação.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Confira a pesquisa global de encerramento para não montar convites repetidos.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

A resposta válida registra a avaliação; o cliente também pode pular.

Observações importantes

  • Notas de 1 a 3 podem gerar retorno em Relatórios. O prazo de pesquisa tem política própria.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Opt-in/opt-out (WhatsApp)

Solicita uma escolha explícita de autorização ou recusa.

Onde encontrarAdministração → Fluxos de atendimento → editor → Opt-in/opt-out (WhatsApp)

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
TextoExplique a finalidade da comunicação.
VariávelNome em que a escolha será registrada.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Opt-in/opt-out (WhatsApp).
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte as saídas Sim e Não respeitando a escolha do contato.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O motor registra a resposta de consentimento no contexto do atendimento.

Observações importantes

  • Uma resposta ambígua não deve ser apresentada como autorização universal. Confira a categoria utilizada pela sua configuração.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Condicional

Compara uma variável ou consulta a condição disponível no bloco.

Onde encontrarAdministração → Fluxos de atendimento → editor → Condicional

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
VariávelDado produzido por um passo anterior.
OperadorIgual, contém, começa com, menor ou maior conforme as opções.
ValorReferência da comparação.
SetorDepartamento cuja agenda será consultada em condições de horário.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Condicional.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte Sim e Não a destinos distintos e teste ambos.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O atendimento segue o caminho resultante da condição.

Observações importantes

  • Consultar a agenda humana não transfere sozinho o contato; ligue um bloco de transferência.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Identificar intenção

Classifica o pedido conforme o catálogo autorizado.

Onde encontrarAdministração → Fluxos de atendimento → editor → Identificar intenção

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Confiança mínimaLimiar exigido para usar o resultado.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Identificar intenção.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Confira as intenções ativas e conecte as decisões que usam ia_intencao, ia_setor ou ia_acao.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O fluxo recebe a classificação, confiança e contexto produzidos pela IA ou regras disponíveis.

Observações importantes

  • Uma intenção reconhecida não substitui identificação e autorização para ações protegidas.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Conversar com agente de IA

Conversa sobre a solicitação com um agente especializado.

Onde encontrarAdministração → Fluxos de atendimento → editor → Conversar com agente de IA

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Agente especializadoSelecione um agente ativo.
Variável com a solicitaçãoDado que contém o pedido do cliente.
Máximo de turnosLimite das trocas previstas para esta etapa.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Conversar com agente de IA.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte a saída à conferência do pedido e só depois às etapas de identificação necessárias.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O agente mantém o contexto da conversa dentro dos limites configurados.

Observações importantes

  • A etapa de conversa não deve ser tratada como consulta cadastral ou execução automática de todas as ferramentas. Confira o resultado e os próximos blocos.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Adicionar etiqueta

Acrescenta uma classificação ao atendimento.

Onde encontrarAdministração → Fluxos de atendimento → editor → Adicionar etiqueta

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
EtiquetaNome da etiqueta; revise variáveis se forem utilizadas.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Adicionar etiqueta.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte ao próximo passo e confira a etiqueta na conversa simulada.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

A etiqueta é adicionada ao atendimento.

Observações importantes

  • Prefira os nomes padronizados no cadastro da empresa.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Autenticação simples

Participa da identificação do titular antes de liberar ações protegidas.

Onde encontrarAdministração → Fluxos de atendimento → editor → Autenticação simples

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Variável CPF/CNPJVariável do documento coletado para identificação.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Autenticação simples.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte a etapa de identificação antes das operações financeiras ou contratuais.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O fluxo executa a rotina de identificação prevista para o cliente.

Observações importantes

  • O documento precisa corresponder ao titular; não exponha dados de um resultado ambíguo.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Auto vincular contato

Tenta localizar o cliente a partir do telefone.

Onde encontrarAdministração → Fluxos de atendimento → editor → Auto vincular contato

Campos e opções

CampoComo preencher
Variável de telefoneDado com o telefone do contato, por exemplo telefone_contato.
Fluxos e automação

Bloco: Identificar no IXC

Localiza o cadastro do assinante no ERP.

Onde encontrarAdministração → Fluxos de atendimento → editor → Identificar no IXC

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Nome/ID do blocoNome claro para a etapa de identificação; use os dados coletados antes dela.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Identificar no IXC.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte a consulta após coletar os dados necessários e trate o insucesso.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

Variáveis de cliente e contrato disponíveis são preenchidas conforme o resultado.

Observações importantes

  • IXC deve estar conectado e permitido; múltiplos contratos exigem contexto correto.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Consultar financeiro

Executa a rotina financeira suportada para títulos, boleto e Pix.

Onde encontrarAdministração → Fluxos de atendimento → editor → Consultar financeiro

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Nome/ID do blocoIdentifique a etapa e confira a identificação do cliente nos passos anteriores.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Consultar financeiro.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Revise a preferência de cobrança e o destino após o resultado financeiro.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O motor executa a rotina de segunda via/Pix implementada, conforme disponibilidade do IXC.

Observações importantes

  • Não é um bloco para baixar pagamentos ou alterar valores. Homologue a preferência Pix/boleto da instalação.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Consultar nota fiscal

Consulta a rotina fiscal implementada para o assinante.

Onde encontrarAdministração → Fluxos de atendimento → editor → Consultar nota fiscal

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Nome/ID do blocoIdentifique a consulta após o vínculo do cliente.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Consultar nota fiscal.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Trate disponibilidade do documento e o resultado antes de informar sucesso.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O resultado fiscal e a disponibilidade/envio de PDF seguem a rotina implementada no IXC.

Observações importantes

  • Não cria nem altera nota fiscal. Confira o documento correto e as condições de envio.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Consultar contrato

Obtém a situação do contrato e do acesso.

Onde encontrarAdministração → Fluxos de atendimento → editor → Consultar contrato

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Nome/ID do blocoNome que indique a consulta contratual.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Consultar contrato.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Use os resultados de contrato/status em uma mensagem ou condição apropriada.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O fluxo recebe situação e contratos disponíveis do cliente.

Observações importantes

  • A consulta não altera plano, endereço ou contrato.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Desbloquear contrato

Solicita desbloqueio de confiança de um contrato elegível.

Onde encontrarAdministração → Fluxos de atendimento → editor → Desbloquear contrato

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Nome/ID do blocoIdentifique a etapa e confira os controles de identificação anteriores.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Desbloquear contrato.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Garanta que o pedido foi compreendido e que existe contrato correto antes da ação.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O resultado do IXC indica se a liberação foi aceita.

Observações importantes

  • Não confirma pagamento. Não use a leitura de comprovante como única autorização.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Integração ERP / IXC

Seleciona uma das operações oferecidas pelo editor.

Onde encontrarAdministração → Fluxos de atendimento → editor → Integração ERP / IXC

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Operação IXCEscolha a ação e confirme se há executor implementado para ela.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Integração ERP / IXC.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Use identificação, segunda via, desbloqueio, nota fiscal ou contrato conforme os executores confirmados.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

Operações implementadas atualizam seu resultado; opções sem executor geram aviso.

Observações importantes

  • Diagnóstico genérico ou aceite eletrônico não devem ser tratados como concluídos apenas por aparecerem na lista.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Criar delay

Aguarda antes de continuar a automação.

Onde encontrarAdministração → Fluxos de atendimento → editor → Criar delay

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Tempo em segundosDefina a espera necessária; o motor consultado limita a 3600 segundos.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Criar delay.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte a saída à etapa que deve executar depois da espera.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O fluxo agenda a retomada depois do atraso.

Observações importantes

  • Delay não é o prazo global de inatividade do cliente e não deve substituir política de horário.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Transferir atendimento

Entrega a conversa ao departamento de destino.

Onde encontrarAdministração → Fluxos de atendimento → editor → Transferir atendimento

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
DepartamentoSetor ativo e autorizado que deve atender a solicitação.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Transferir atendimento.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Escolha um setor com equipe e horários configurados e termine a etapa automática nesse encaminhamento.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

A conversa é encaminhada à operação humana conforme disponibilidade e regras do setor.

Observações importantes

  • Fora do expediente ou sem atendente disponível, a conversa pode permanecer em fila.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Executar fluxo

Chama outro fluxo publicado e mantém um ponto de retorno.

Onde encontrarAdministração → Fluxos de atendimento → editor → Executar fluxo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
FluxoSelecione um fluxo ativo e publicado desta empresa.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Executar fluxo.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Conecte a saída à etapa que deve continuar após o subfluxo.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

A execução passa ao subfluxo e pode retornar à sequência anterior.

Observações importantes

  • Evite chamadas recursivas sem saída e confira a versão publicada do destino.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Enviar notificação

Oferece configuração de notificação no editor, com limite no executor atual.

Onde encontrarAdministração → Fluxos de atendimento → editor → Enviar notificação

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
CanalCampo exibido no editor; confira o limite operacional.
DestinatárioCampo não deve ser tomado como prova de envio a outro contato.
TextoTexto utilizado pela implementação disponível.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Enviar notificação.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Na base consultada, planeje este bloco como mensagem na conversa atual.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O executor consultado trata message e notification como texto do atendimento atual.

Observações importantes

  • Não representa disparo independente por SMS/e-mail; utilize um conector/rotina efetivamente homologado para essa necessidade.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Fim do fluxo automático

Encerra a automação e preserva a conversa operacional.

Onde encontrarAdministração → Fluxos de atendimento → editor → Fim do fluxo automático

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Nome/ID do blocoNome que deixe claro que apenas o fluxo automático termina.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Fim do fluxo automático.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Escolha o ponto em que a automação deve parar; use transferência para encaminhar explicitamente a um setor.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

A automação termina; a conversa continua na fila ou com o atendente conforme seu estado.

Observações importantes

  • Não confunda com Encerrar atendimento ou com a pesquisa final.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Abrir atendimento pelo WhatsApp

Bloco disponível para configuração visual, ainda dependente de executor específico na base consultada.

Onde encontrarAdministração → Fluxos de atendimento → editor → Abrir atendimento pelo WhatsApp

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
TelefoneTelefone ou variável, como {{telefone_contato}}.
TextoConteúdo pretendido pela configuração.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Abrir atendimento pelo WhatsApp.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Para realizar a tarefa atualmente, use Abertura de chamado e Enviar HSM no painel.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O desenho pode ser salvo, mas este bloco não comprova a execução da ação externa.

Observações importantes

  • O motor consultado registra que o bloco requer executor específico. Não publique um caminho operacional dependendo desta ação sem confirmação técnica.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Conta

Bloco disponível para configuração visual, ainda dependente de executor específico na base consultada.

Onde encontrarAdministração → Fluxos de atendimento → editor → Conta

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
OperaçãoSomar, subtrair ou definir valor.
VariávelNome do contador pretendido.
ValorQuantidade para a operação.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Conta.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Para realizar a tarefa atualmente, use uma regra validada pelo suporte antes de depender de um contador.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O desenho pode ser salvo, mas este bloco não comprova a execução da ação externa.

Observações importantes

  • O motor consultado registra que o bloco requer executor específico. Não publique um caminho operacional dependendo desta ação sem confirmação técnica.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Desviar ligação

Bloco disponível para configuração visual, ainda dependente de executor específico na base consultada.

Onde encontrarAdministração → Fluxos de atendimento → editor → Desviar ligação

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Destino da ligaçãoDestino previsto para telefonia.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Desviar ligação.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Para realizar a tarefa atualmente, use o discador disponível no painel; desvios reais dependem do PABX.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O desenho pode ser salvo, mas este bloco não comprova a execução da ação externa.

Observações importantes

  • O motor consultado registra que o bloco requer executor específico. Não publique um caminho operacional dependendo desta ação sem confirmação técnica.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Marcar horário na agenda

Bloco disponível para configuração visual, ainda dependente de executor específico na base consultada.

Onde encontrarAdministração → Fluxos de atendimento → editor → Marcar horário na agenda

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Título do compromissoIdentificação do agendamento pretendido.
Duração em minutosDuração desejada.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Marcar horário na agenda.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Para realizar a tarefa atualmente, use agendamento da OS no IXC ou procedimento interno aprovado.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O desenho pode ser salvo, mas este bloco não comprova a execução da ação externa.

Observações importantes

  • O motor consultado registra que o bloco requer executor específico. Não publique um caminho operacional dependendo desta ação sem confirmação técnica.
  • Agendar conversa no atendimento é um lembrete interno separado. A existência desse comando não habilita o executor deste bloco de agenda do fluxo.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Requisição HTTP

Bloco disponível para configuração visual, ainda dependente de executor específico na base consultada.

Onde encontrarAdministração → Fluxos de atendimento → editor → Requisição HTTP

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
MétodoGET ou POST.
EndpointDestino autorizado.
Corpo da requisiçãoDados pretendidos pela integração.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Requisição HTTP.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Para realizar a tarefa atualmente, use conector HTTP e implementação técnica homologada para a ação.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O desenho pode ser salvo, mas este bloco não comprova a execução da ação externa.

Observações importantes

  • O motor consultado registra que o bloco requer executor específico. Não publique um caminho operacional dependendo desta ação sem confirmação técnica.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Template interativo

Bloco disponível para configuração visual, ainda dependente de executor específico na base consultada.

Onde encontrarAdministração → Fluxos de atendimento → editor → Template interativo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Nome do templateIdentificador pretendido pelo canal.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Template interativo.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Para realizar a tarefa atualmente, use Enviar HSM ou campanhas com modelos aprovados.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O desenho pode ser salvo, mas este bloco não comprova a execução da ação externa.

Observações importantes

  • O motor consultado registra que o bloco requer executor específico. Não publique um caminho operacional dependendo desta ação sem confirmação técnica.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Bloco: Enviar arquivo

Bloco disponível para configuração visual, ainda dependente de executor específico na base consultada.

Onde encontrarAdministração → Fluxos de atendimento → editor → Enviar arquivo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
ArquivoReferência do arquivo pretendido.

Passo a passo

  1. Abra o fluxo como rascunho e selecione o bloco Enviar arquivo.
  2. Confira seu ID único e dê um nome que explique a tarefa.
  3. Preencha os campos descritos na tabela.
  4. Para realizar a tarefa atualmente, use menu de anexos do atendimento.
  5. Revise as conexões de entrada e saída aplicáveis. Execute a validação e leia os avisos antes de publicar.

Resultado esperado

O desenho pode ser salvo, mas este bloco não comprova a execução da ação externa.

Observações importantes

  • O motor consultado registra que o bloco requer executor específico. Não publique um caminho operacional dependendo desta ação sem confirmação técnica.

Se precisar de ajuda

  • Se a validação indicar ausência de executor, não considere a ação realizada.
  • Se faltar uma variável ou referência, confira a etapa anterior, a integração e o cadastro de destino.
Fluxos e automação

Fluxo sem IA: menu 1 Suporte, 2 Comercial, 3 Financeiro

Monte ou importe um atendimento por números, com cinco setores, opção de atendente e retorno ao menu para respostas inválidas. Inclui imagens e modelo pronto.

Onde encontrarConfigurações → Fluxos de atendimento → Importar fluxo ou Novo fluxo

Antes de começar

  • Acesse como administrador autorizado a configurar fluxos.
  • Cadastre e ative Suporte Técnico, Comercial, Financeiro, Agendamentos e Renegociação, ou adapte os destinos aos setores existentes.
  • Confira usuários, distribuição e horário geral de atendimento.
  • Não é necessário configurar provedor de IA para este desenho. O canal de atendimento precisa estar configurado normalmente.

Passo a passo

  1. Confira os departamentos e baixe o modelo deste artigo.
  2. Importe o arquivo ou monte os blocos seguindo as imagens e tabelas abaixo.
  3. Teste todas as opções e a resposta inválida. Publique a versão aprovada.
  4. Escolha o fluxo publicado no canal que atenderá sem IA.
EXEMPLO PARA REPRODUZIR

O cliente escolhe um número. O fluxo encaminha ao setor.

Este exemplo funciona sem IA. A pergunta salva a escolha em opcao_menu; as condições comparam o número e transferem a conversa para pessoas. Você pode importar o modelo pronto ou reproduzir a montagem abaixo.

Imagens ilustrativas do editor, com dados fictícios. Elas explicam os campos e não representam uma captura da sua instalação.

Mapa do menu sem IA: pergunta, opções 1 a 5 e 0, transferência humana e retorno ao menu em resposta inválida.
Visão simplificada da lógica. A tabela de conexões abaixo mostra os 15 blocos do arquivo importável. Ampliar imagem ↗

Importe o modelo pronto ou comece um fluxo novo

Para o caminho mais rápido, baixe menu-sem-ia.json no final deste artigo. Em Fluxos de atendimento, clique em Importar fluxo e selecione o arquivo. O resultado esperado é um rascunho chamado Sem IA · Menu de atendimento.

O arquivo é um modelo original desta wiki no formato aceito pelo importador do Omnichannel. Ele contém nomes de setores, sem credenciais ou dados de clientes. Não é um arquivo de credenciais nem uma exportação autenticada de terceiros.

Leia o resultado da importação. Abra Editar e confira os cinco departamentos de transferência. Se os nomes forem diferentes em sua empresa, selecione os departamentos correspondentes.

Para montar manualmente, clique em Novo fluxo, dê o mesmo nome e crie os blocos na ordem da próxima etapa. Não importe e monte outra cópia ao mesmo tempo.

Crie os blocos na ordem do exemplo

O Início já existe. Adicione os demais blocos na ordem da tabela para reproduzir os IDs B01 a B15. Se os IDs gerados forem diferentes, use os nomes e a função de cada bloco como referência.

O modelo importado chama as decisões de Condição. Clique em cada uma para ver o valor comparado. Você pode renomeá-las para Opção 1?, Opção 2? e assim por diante.

Preencha assim
CampoValor do exemplo
B01Início
B02Enviar pergunta — menu; variável opcao_menu
B03 / B04Condicional opção 1 / Transferir: Suporte Técnico
B05 / B06Condicional opção 2 / Transferir: Comercial
B07 / B08Condicional opção 3 / Transferir: Financeiro
B09 / B10Condicional opção 4 / Transferir: Agendamentos
B11 / B12Condicional opção 5 / Transferir: Renegociação
B13Condicional opção 0 — usa a transferência B04
B14Enviar mensagem — opção inválida
B15Fim do fluxo automático

Preencha a pergunta que apresenta o menu

Selecione B02, do tipo Enviar pergunta. Cole o texto abaixo e use opcao_menu no campo Variável, sem chaves. Mantenha Sem validação específica; as condições seguintes validam quais opções existem.

Não use Enviar mensagem para aguardar uma escolha. É a pergunta que pausa a execução e salva a próxima resposta.

A variável {{nome_empresa}} é substituída pelo nome da empresa da instalação. Ela pode ser usada no texto, mas o campo Variável recebe somente opcao_menu.

Olá! Você está no atendimento da {{nome_empresa}}.

Digite a opção desejada:
1 - Suporte
2 - Comercial
3 - Financeiro
4 - Agendamentos
5 - Renegociação
0 - Falar com um atendente
Preencha assim
CampoValor do exemplo
TipoEnviar pergunta
Variávelopcao_menu
ValidaçãoSem validação específica
Pergunta com opções 1 Suporte, 2 Comercial, 3 Financeiro, 4 Agendamentos, 5 Renegociação e 0 atendente; variável opcao_menu.
Copie o texto e use uma pergunta para aguardar a escolha do cliente. Ampliar imagem ↗

Configure as seis condições e os cinco destinos

Em cada Condicional, preencha Variável com opcao_menu e Operador com Igual a. No Valor, coloque apenas o número correspondente: 1, 2, 3, 4, 5 ou 0.

Cada Sim leva à transferência daquele setor. Cada Não verifica o próximo número. O Não da última condição, opção 0, leva à mensagem de opção inválida.

Abra cada Transferir atendimento e escolha o departamento real no seletor. Digitar o nome do cartão não configura o destino.

A opção 0 também leva ao Suporte Técnico neste modelo. Para uma recepção própria, crie outra transferência e ajuste a conexão Sim de B13.

Preencha assim
CampoValor do exemplo
B03 / Sim → B041 → Suporte Técnico
B05 / Sim → B062 → Comercial
B07 / Sim → B083 → Financeiro
B09 / Sim → B104 → Agendamentos
B11 / Sim → B125 → Renegociação
B13 / Sim → B040 → Suporte Técnico / pessoa
Condição opcao_menu Igual a 1; Sim vai ao Suporte Técnico e Não verifica a opção 2.
A decisão usa a resposta exata, sem classificação por inteligência artificial. Ampliar imagem ↗

Conecte os blocos e prepare a resposta inválida

Use Nova conexão e preencha origem, tipo de saída e destino conforme a tabela. Em cada condição, crie Não antes de Sim: o editor inicia uma ligação de condição com Sim e pode substituir outra saída Sim existente.

No B14, configure o texto: Não encontrei essa opção. Responda 1, 2, 3, 4, 5 ou 0 para falar com um atendente.

A ligação de B14 para B02 reapresenta o menu e aguarda outra resposta. Ela não deve voltar diretamente à condição nem criar um ciclo só de mensagens.

As transferências ligam ao B15 para completar a estrutura. Na execução, a transferência já pausa a automação e entrega a conversa à equipe; não encerra o atendimento.

Conexões, na ordem de criação
OrigemSaídaDestino
B01PróximoB02
B02PróximoB03
B03NãoB05
B03SimB04
B05NãoB07
B05SimB06
B07NãoB09
B07SimB08
B09NãoB11
B09SimB10
B11NãoB13
B11SimB12
B13NãoB14
B13SimB04
B14PróximoB02
B04PróximoB15
B06PróximoB15
B08PróximoB15
B10PróximoB15
B12PróximoB15

Valide e simule cada escolha

Se você montou ou editou o fluxo, use Testar rascunho → Apenas validar graficamente (sem enviar) → Executar teste. Confira 15 blocos, 20 conexões e sete caminhos. Depois clique em Salvar rascunho.

O aviso de ciclo é esperado exclusivamente no retorno B14 → B02. Confirme que o caminho passa pela pergunta e aguarda a próxima mensagem.

Abra Testar versão salva → Simular resposta em canal. Escolha o canal, envie Olá como primeira mensagem e clique em Iniciar conversa. Quando o menu aparecer, preencha Responder como cliente com 1 e envie.

Confira Suporte Técnico. Use Reiniciar conversa entre os testes e repita com 2, 3, 4, 5 e 0. Confira o destino no resultado da transferência; a mensagem de horário usa o calendário geral nas versões atuais.

Teste 9: deve aparecer o aviso e um novo menu. Responda 2 nessa mesma conversa: deve encaminhar para Comercial. Repita com texto fora das opções para conferir a orientação.

O teste usa o motor do atendimento em uma simulação. Este modelo não tem IA, consultas ao IXC ou ferramentas que alteram contratos. Use mensagens fictícias.

Simulação da resposta 9 com aviso de opção inválida, seguida de 2 e transferência para Comercial.
Verifique as seis escolhas e a recuperação após uma resposta inválida. Ampliar imagem ↗

Ative o cadastro e publique a versão aprovada

Nas versões a partir de 0.45.10, você também pode publicar e depois usar Ativar fluxo diretamente na biblioteca. Se o botão não existir, use o cadastro Ativo no editor, como explicado abaixo.

Confira a opção Ativo no editor. O importador pode criar o cadastro inativo: marque Ativo para disponibilizá-lo à seleção de canais.

Mudou qualquer campo ou marcou Ativo? Teste a revisão atual antes de Salvar rascunho. Depois teste a versão salva novamente.

Clique em Publicar e confira o selo Publicado com o número da versão na biblioteca. A publicação não escolhe automaticamente um canal.

Na sua instalação, use a biblioteca para localizar Sem IA · Menu de atendimento. Evite reimportar sobre adaptações feitas para uma empresa sem antes conferir o rascunho.

Ordem de validação e publicação: testar rascunho, salvar rascunho, testar versão salva e publicar.
O teste deve corresponder à revisão que será publicada. Ampliar imagem ↗

Use em um cliente sem IA e amplie o menu

No canal autorizado, abra Integrações e selecione Sem IA · Menu de atendimento em Fluxo de entrada. Salve ou clique em Aplicar, conforme a configuração do canal. Confira o fluxo anterior antes da troca.

Para outra empresa, importe o arquivo na instalação de destino e revise todos os departamentos. Os nomes do modelo não criam setores automaticamente.

Para adicionar 6 — Ouvidoria, crie um departamento e uma transferência, acrescente a linha ao texto do menu e adicione uma Condicional opcao_menu Igual a 6 entre a opção 5 e a opção 0.

Ligue o Não de B11 à nova condição; seu Sim à nova transferência; seu Não a B13. Ligue a transferência ao Fim. Atualize também o texto de opção inválida para incluir 6.

Teste todas as opções novamente, salve, teste a versão salva e publique. Não é necessário acrescentar IA para ampliar o menu.

ESCOLHAS E RESULTADOS

Abra um exemplo e acompanhe o caminho

Demonstração ilustrativa com resultados descritos. Esta wiki não executa IA, consultas ao IXC ou envios de mensagens.

1 — Suporte
MENSAGEM DO CLIENTE
1

opcao_menu: 1

B01 → B02 → B03 Sim → B04

Encaminha à equipe de Suporte Técnico e respeita o horário geral de atendimento.

2 — Comercial
MENSAGEM DO CLIENTE
2

opcao_menu: 2

B01 → B02 → B03 Não → B05 Sim → B06

Encaminha ao Comercial; a negociação é feita pelo atendente.

3 — Financeiro
MENSAGEM DO CLIENTE
3

opcao_menu: 3

B01 → B02 → B03 Não → B05 Não → B07 Sim → B08

Encaminha ao Financeiro. Não consulta nem envia boleto automaticamente.

4 — Agendamentos
MENSAGEM DO CLIENTE
4

opcao_menu: 4

B01 → B02 → condições até B09 Sim → B10

Encaminha à equipe de Agendamentos. Não cria compromisso sozinho.

5 — Renegociação
MENSAGEM DO CLIENTE
5

opcao_menu: 5

B01 → B02 → condições até B11 Sim → B12

Encaminha à equipe de Renegociação sem alterar valores ou contratos.

0 — Falar com um atendente
MENSAGEM DO CLIENTE
0

opcao_menu: 0

B01 → B02 → condições até B13 Sim → B04

Encaminha ao Suporte Técnico como recepção humana deste modelo.

9 — Opção inválida
MENSAGEM DO CLIENTE
9

opcao_menu: 9

Condições Não → B14 → B02 → aguarda nova resposta

O aviso aparece e o menu é repetido. Ao responder 2, segue para Comercial.

Importe o mesmo modelo na sua instalação

Arquivo original da wiki, compatível com Importar fluxo no Omnichannel. Depois de importar, confira departamentos e Ativo, teste e publique antes de aplicar ao canal.

Baixar modelo pronto para importar (.json)

Resultado esperado

Menu determinístico: a resposta do cliente define o setor, sem classificação por IA e sem consultas automáticas ao IXC.

Observações importantes

  • O modelo usa 15 blocos e 20 conexões. Não utiliza Identificar intenção, agente de IA nem ferramentas IXC.
  • As imagens são ilustrações didáticas. Os nomes e IDs ajudam a reproduzir o modelo importável.
  • A opção 0 usa Suporte Técnico como recepção humana. Troque esse destino se sua empresa tiver outro setor de recepção.
  • As opções Financeiro e Renegociação transferem para pessoas: não emitem boleto, não negociam valores e não alteram contratos.
  • A repetição após uma opção inválida é intencional. A pergunta aguarda nova mensagem, evitando uma repetição automática sem espera.
  • Importar o mesmo modelo novamente pode atualizar o rascunho associado à importação. Confira alterações locais antes de reimportar.
  • Nas versões com horário geral (a partir de 0.45.5), as transferências seguem o calendário único da empresa. Referências a horários de setor em versões anteriores devem ser lidas como horário geral nas versões atuais.

Se precisar de ajuda

  • Departamento não resolvido: abra cada Transferir atendimento e selecione o setor correto antes de publicar.
  • Menu não aguarda: confirme que B02 é Enviar pergunta e salva opcao_menu; Enviar mensagem não substitui a pergunta.
  • Número não segue o caminho esperado: confira Variável opcao_menu, operador Igual a, valor e saídas Sim/Não.
  • Aviso de ciclo: confira que a volta passa por B02, que aguarda resposta. Um ciclo apenas de mensagens não é este modelo.
  • Fluxo publicado não aparece no canal: confira o cadastro Ativo e a publicação. Importar sozinho cria um rascunho.
  • Transferência fora do horário: o motor utiliza o horário geral de atendimento. Ajuste a operação, não prometa atendimento imediato.
Fluxos e automação

Ativar um fluxo publicado sem abrir o editor

Entenda Publicado e Ativo, ative uma versão da biblioteca e atualize a seleção do agente.

Onde encontrarConfigurações → Fluxos de atendimento → Ativar fluxo

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira a versão da instalação: a ação direta está documentada a partir de 0.45.10.
  2. Localize o fluxo e confira separadamente os estados Publicado/Rascunho e Ativo/Inativo.
  3. Revise os canais e agentes já vinculados: ativar permite executar a versão publicada nesses vínculos.
  4. Se o fluxo estiver publicado e inativo, clique em Ativar fluxo e aguarde a confirmação de Ativo.
  5. Se só houver rascunho, teste e publique uma versão antes de ativar. A ação não substitui a publicação.
  6. Na configuração do agente, use Atualizar fluxos e selecione o fluxo inicial. Quando oferecido, Ativar fluxo publicado faz a mesma ativação a partir dessa tela.
  7. Revise o agente e salve seu próprio estado. Faça a associação ao canal apenas quando aquela operação estiver pronta.

Resultado esperado

A versão publicada fica ativa, preservando o rascunho e os vínculos existentes.

Observações importantes

  • O recurso depende da atualização da instalação. A preparação de uma versão comercial não significa que todos os clientes já a receberam.
  • Ativar não publica alterações pendentes nem ativa agentes automaticamente.
  • O estado ativo pode afetar vínculos existentes. Confira-os antes de acionar.
  • Nas versões anteriores, abra o editor, marque Ativo e siga a sequência de teste, salvamento e publicação apresentada pelo painel.

Se precisar de ajuda

  • Botão desabilitado: confira se existe uma versão publicada e se a conta tem permissão.
  • Agente informa fluxo não publicado: publique uma versão e atualize a lista.
  • Agente informa fluxo inativo: ative a versão publicada e consulte a lista novamente.
  • Se a lista continuar antiga, use Atualizar fluxos e leia o retorno antes de salvar.
Campanhas

Criar e revisar uma campanha de WhatsApp

Prepare um rascunho com destinatários autorizados, template e objetivo de acompanhamento.

Onde encontrarMenu → Envio em massa → Novo envio

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
NomeIdentificação interna da campanha.
Canal e setorNúmero de origem e departamento autorizado.
ModeloTemplate aprovado e compatível com campanhas.
VariáveisNome/telefone do contato ou texto fixo.
ObjetivoResposta, pagamento identificado ou entrega/leitura.
PrazoDe 1 a 90 dias para acompanhar o objetivo.
AgendamentoOpcional; confira o horário local exibido.

Passo a passo

  1. Preencha nome da campanha, canal WhatsApp e setor.
  2. Escolha um template aprovado disponível ao setor.
  3. Configure as variáveis usando nome do cliente, telefone ou texto fixo, conforme o formulário.
  4. Escolha o objetivo: resposta, pagamento identificado no IXC ou somente entrega e leitura.
  5. Defina o prazo de medição e o agendamento, se desejar.
  6. Busque e selecione os contatos com consentimento ativo compatível.
  7. Revise destinatários, conteúdo, variáveis e horário.
  8. Salve o rascunho; use o procedimento de iniciar somente após a revisão.

Resultado esperado

A campanha é criada como rascunho e não dispara apenas por ser salva.

Observações importantes

  • O prazo de resultado documentado varia de 1 a 90 dias.
  • Cabeçalhos ou botões dinâmicos não suportados em campanhas são recusados mesmo que o template funcione em outro envio.
  • Consentimento e opt-out são revalidados no disparo.

Se precisar de ajuda

  • Contato indisponível: confira categoria do consentimento e descadastro.
  • Template recusado: escolha um formato compatível com campanhas.
Campanhas

Iniciar, agendar ou cancelar uma campanha

Confirme o envio do rascunho e acompanhe o processamento de forma controlada.

Onde encontrarEnvio em massa → Histórico de envios

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Localize o rascunho e confira seu nome, canal, conteúdo e destinatários.
  2. Confirme que o agendamento está correto e ainda é futuro quando essa opção for usada.
  3. Clique em Iniciar e conclua a confirmação.
  4. Acompanhe se a campanha ficou agendada, enfileirada ou em processamento.
  5. Para interromper um envio elegível, use Cancelar e confirme.
  6. Abra os resultados para conferir o que já havia sido processado.

Resultado esperado

A campanha passa ao agendamento ou processamento, ou tem os próximos envios cancelados quando permitido.

Observações importantes

  • Cancelar não recolhe mensagens já enviadas.
  • Não crie uma campanha nova apenas porque a anterior ainda está enfileirada.
  • Iniciar envia mensagens reais aos contatos selecionados.

Se precisar de ajuda

  • Iniciar indisponível: confira status, permissões, modelo e destinatários.
  • Erro de data: selecione um horário futuro.
Campanhas

Acompanhar resultados e repetir uma falha elegível

Separe enfileiramento, entrega, leitura, resposta e objetivo alcançado.

Onde encontrarEnvio em massa → campanha → detalhes dos destinatários

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Atualize o histórico de envios.
  2. Confira enfileirados, enviados, entregues, lidos, sem entrega confirmada, ignorados e falhas.
  3. Abra o detalhe dos destinatários para consultar erro e quantidade de tentativas.
  4. Se a falha for elegível e a opção estiver disponível, solicite repetição apenas do destinatário afetado.
  5. Para objetivo de pagamento, use Conferir pagamentos no IXC e aguarde a atualização.
  6. Confira respostas, descadastros e objetivo dentro do prazo configurado.

Resultado esperado

Você acompanha o resultado real de cada etapa sem confundir fila com entrega.

Observações importantes

  • Lidos estão incluídos nos entregues e enviados; não some essas contagens como públicos distintos.
  • Repetições elegíveis têm limite de três tentativas e revalidam consentimento.
  • Conferir pagamento registra a situação do IXC e não envia uma confirmação ao cliente.
  • Resultado de pagamento é uma correlação operacional, não prova que a campanha causou a quitação.

Se precisar de ajuda

  • Sem confirmação de entrega: aguarde os eventos do canal e confira os logs.
  • Sem objetivo de pagamento: confira vínculo IXC e títulos acompanhados.
Campanhas

Registrar consentimento e respeitar descadastro

Mantenha autorização compatível com a categoria de comunicação do WhatsApp.

Onde encontrarClientes → contato → Consentimento para WhatsApp

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Localize o contato e confira a identidade correta.
  2. Consulte as categorias e a situação do consentimento.
  3. Registre autorização apenas quando tiver uma manifestação real e a evidência exigida pela empresa.
  4. Se o cliente pedir descadastro, utilize a ação de revogar/retirar consentimento disponibilizada na tela.
  5. Confira o estado atualizado antes de selecionar o contato para campanha.
  6. Em fluxos, use o bloco de opt-in/opt-out para colher uma resposta explícita.

Resultado esperado

O cadastro representa a escolha do contato e restringe seleções e disparos conforme a categoria.

Observações importantes

  • Existir no cadastro ou ter feito uma compra não deve ser tratado automaticamente como opt-in para todas as finalidades.
  • Consentimento de campanha e atendimento solicitado pelo cliente são contextos distintos.
  • A wiki descreve o controle do sistema; a política de tratamento deve ser definida pela empresa.

Se precisar de ajuda

  • Contato continua indisponível: confira categoria, status de revogação e atualização da lista.
Equipe e empresa

Criar usuário e entregar o primeiro acesso

Cadastre a equipe com perfil, setores e senha temporária individual.

Onde encontrarAdministração → Usuários → novo cadastro

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
Nome e e-mailDados individuais do usuário.
PerfilConjunto de permissões.
Sessões simultâneasEntre 1 e 10 conforme o formulário.
SetoresDepartamentos permitidos ao atendente.
Dois fatoresExigência individual quando marcada.

Passo a passo

  1. Abra o cadastro de usuário e informe nome e e-mail.
  2. Escolha o perfil de permissão correspondente à função.
  3. Defina o limite de sessões simultâneas.
  4. Marque Exigir autenticação em dois fatores quando necessário.
  5. Selecione os setores que o atendente poderá atender.
  6. Salve e copie a senha temporária exibida uma única vez.
  7. Entregue endereço do painel, e-mail e senha temporária por meio reservado.
  8. Oriente o usuário a trocar a senha e concluir o segundo fator antes de atender.

Resultado esperado

O usuário passa a ter acesso conforme perfil, status e departamentos.

Observações importantes

  • Administrador pode ficar sem setor, mas não recebe distribuição automática.
  • Uma conta individual facilita identificar quem realizou cada ação.
  • Não compartilhe uma senha entre toda a equipe.

Se precisar de ajuda

  • E-mail recusado: confira duplicidade e formato.
  • Sem menu ou fila: revise perfil e setores após o primeiro login.
Equipe e empresa

Editar, inativar e redefinir acesso de usuários

Atualize perfil e setores, bloqueie acesso e gerencie dispositivos de um usuário.

Onde encontrarAdministração → Usuários

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Localize o usuário e abra Editar.
  2. Atualize nome, e-mail, perfil, limite de sessões e setores.
  3. Para suspender o acesso, escolha Inativo ou Bloqueado conforme a política da empresa.
  4. Ative a exigência de dois fatores quando apropriado.
  5. Em Autenticação e dispositivos, revogue um dispositivo que não deve continuar confiável.
  6. Salve e confira o cadastro.
  7. Para senha, utilize Redefinir senha na lista; o formulário de edição não altera a senha.

Resultado esperado

O cadastro passa a refletir o acesso e a situação desejados.

Observações importantes

  • Antes de inativar alguém, confira atendimentos sob sua responsabilidade.
  • Revogar confiança de um dispositivo e encerrar sessões são ações com efeitos distintos.
  • O perfil Administrador possui tratamento protegido no catálogo de permissões.

Se precisar de ajuda

  • Alteração não aplicada: atualize a lista e confira a resposta do formulário.
  • Perda de acesso após trocar perfil: revise as permissões e departamentos.
Equipe e empresa

Criar e ajustar perfis de permissão

Controle o que cada função pode visualizar, atender e administrar.

Onde encontrarAdministração → Permissões

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Novo perfil ou selecione um perfil existente.
  2. Informe um nome que represente a função.
  3. Marque as permissões necessárias: visualizar, atribuir, transferir, enviar mensagens, consultar clientes/IXC, relatórios ou campanhas conforme a função.
  4. Salve permissões.
  5. Em Usuários, atribua o perfil à conta desejada e confira seus setores.
  6. Verifique o menu e o acesso com uma conta de homologação desse perfil.

Resultado esperado

Usuários do perfil recebem o conjunto de ações permitido, combinado com o escopo dos departamentos.

Observações importantes

  • O perfil Administrador é protegido contra edição nesta tela.
  • Permissão de visualizar não implica permissão de enviar ou transferir.
  • Licença e permissão são controles distintos: um perfil não libera um módulo não contratado.

Se precisar de ajuda

  • Menu ausente: revise perfil, setor e licença.
  • Permissão adicional com nome técnico: solicite ao suporte a finalidade antes de conceder.
Equipe e empresa

Criar departamentos e definir SLA

Separe a operação em setores e configure os prazos de acompanhamento.

Onde encontrarAdministração → Departamentos → novo cadastro

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
NomeIdentificação do setor.
Primeira respostaPrazo em minutos.
ResoluçãoPrazo em horas.

Passo a passo

  1. Clique para criar um departamento.
  2. Preencha o nome do setor.
  3. Informe o prazo de primeira resposta em minutos e de resolução em horas.
  4. Salve e confira o setor na lista.
  5. Vincule usuários ao setor em Administração → Usuários.
  6. Confira o horário geral e selecione o setor nos fluxos e canais necessários.

Resultado esperado

O setor fica disponível para roteamento e acompanhamento dos prazos.

Observações importantes

  • Nas versões a partir de 0.45.11, a lista também oferece Editar e Excluir. Veja o guia de manutenção de departamentos.
  • Criar um setor não adiciona atendentes automaticamente.
  • O horário humano é geral nas versões atuais; SLA é um indicador do setor, não um calendário nem garantia de resposta automática.

Se precisar de ajuda

  • Fila sem distribuição: confira usuários ativos, vínculos e presença.
  • Prazo inadequado em setor existente: procure o responsável pela administração da instalação.
Equipe e empresa

Configurar o horário geral de atendimento humano

Defina os turnos e a mensagem fora do expediente para toda a operação.

Onde encontrarAdministração → Períodos de atendimento

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Configurações → Períodos de atendimento e crie um período ou edite um existente.
  2. Informe um nome para o turno. Nas versões com horário geral, não há seleção de departamento.
  3. Marque os dias da semana e preencha início e fim.
  4. Configure a mensagem fora do horário no campo correspondente, confira Ativo e salve.
  5. Cadastre outro período para o segundo turno: por exemplo, segunda a sexta de 08h a 12h e de 14h a 18h.
  6. Confira a prévia do horário geral e os feriados. Use Mostrar períodos inativos para revisar cadastros antigos.

Resultado esperado

Todos os setores seguem o mesmo horário humano e a orientação fora do expediente.

Observações importantes

  • A partir da versão 0.45.5, um calendário geral atende todos os setores, fluxos e canais. Períodos antigos ativos também são interpretados como parte desse calendário.
  • Revise períodos antigos para evitar sobreposições ou turnos extras não desejados.
  • Agentes virtuais ativos podem atender 24x7; períodos e feriados regulam a disponibilidade da equipe humana.
  • Feriados têm prioridade sobre a grade semanal.
  • A ausência de período aplicável pode preservar operação 24x7; configure explicitamente a disponibilidade pretendida.
  • A possibilidade de o administrador assumir pessoalmente fora do horário é uma exceção operacional; ela não muda o calendário da empresa nem libera a distribuição automática.

Se precisar de ajuda

  • Setor aparece fechado: confira fuso, dias, horários e feriado aplicável.
  • Setor aberto sem distribuição: confira usuários online e permissões.
Equipe e empresa

Cadastrar feriados e expediente especial

Determine dias fechados ou horários específicos que prevalecem sobre a rotina semanal.

Onde encontrarAdministração → Feriados

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Informe nome e data do feriado.
  2. Marque Repetir anualmente quando o evento se repetir na mesma data.
  3. Em Trabalha neste feriado?, selecione fechado, todo o dia ou horário específico.
  4. Para expediente parcial, informe início e fim.
  5. Ative o cadastro e salve.
  6. Confira a prévia de disponibilidade e edite ou exclua um cadastro incorreto com a confirmação da tela.

Resultado esperado

O feriado define a disponibilidade humana na data correspondente.

Observações importantes

  • A regra de feriado tem prioridade sobre o período semanal.
  • Os agentes virtuais continuam disponíveis conforme sua ativação.

Se precisar de ajuda

  • Regra aplicada no dia errado: confira data, repetição anual e fuso da empresa.
  • Horário contraditório: revise cadastros duplicados.
Equipe e empresa

Configurar Empresa por abas

Encontre dados cadastrais, operação, pesquisa e política de sessão nas seções da empresa.

Onde encontrarConfigurações → Empresa

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Configurações → Empresa e confira a aba Cadastro para identificação, contatos, endereço e site.
  2. Abra Atendimento para prefixo de protocolos, fuso horário e regras de inatividade no atendimento automatizado.
  3. Quando o recurso de capacidade estiver contratado, use Distribuição para suas configurações específicas. A ausência dessa aba pode ser uma condição da licença.
  4. Em Pesquisa, revise o envio automático no encerramento, o prazo e as mensagens ou imagens anteriores à avaliação.
  5. Em Sessões, confira Encerrar login após inatividade para a equipe.
  6. Use Salvar para aplicar as alterações. Trocar de aba não salva automaticamente os campos.
  7. Após a confirmação, reabra a tela e confira os valores. Se houver conflito com edição de outro administrador, recarregue os dados e refaça somente a mudança necessária.

Resultado esperado

Os dados da empresa são atualizados, preservando a identidade visual do Omnichannel.

Observações importantes

  • Cadastro é o nome da aba de dados da empresa; identidade visual do produto, logo e favicon não são editados nesse formulário.
  • Inatividade do cliente no robô, prazo da pesquisa e inatividade do login são configurações diferentes.
  • O calendário de atendimento humano continua em Períodos de atendimento e Feriados; o fuso é informado na empresa.
  • Desativar a pesquisa preserva seu conteúdo para futura reativação. Não apaga avaliações anteriores.
  • A aba Distribuição depende da licença de capacidade e pode ter controles e salvamento próprios. Confira a confirmação da operação usada.

Se precisar de ajuda

  • Se um campo de marca não aparecer, isso é o comportamento esperado nas versões atuais.
  • Se o salvamento falhar, confira permissões, campos obrigatórios e a mensagem da tela.
Equipe e empresa

Definir o encerramento do login por inatividade

Ajuste o prazo sem uso do painel que encerra as sessões da equipe.

Onde encontrarConfigurações → Empresa → Sessões

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Localize Encerrar login após inatividade.
  2. Informe o prazo em minutos, de 1 a 1440.
  3. Salve a configuração.
  4. Avise a equipe sobre o prazo escolhido.
  5. Confira o comportamento em uma conta de homologação sem atendimentos reais em curso.

Resultado esperado

O usuário sem atividade pelo prazo configurado fica offline e precisa entrar novamente.

Observações importantes

  • A política vale para a empresa e alcança usuários conectados em até um minuto.
  • Este prazo é diferente de inatividade do cliente no robô e do tempo da pesquisa.

Se precisar de ajuda

  • Login encerrando cedo: confira o valor salvo e se houve atividade reconhecida pelo painel.
  • Alteração ainda não refletida: aguarde a atualização da política.
Equipe e empresa

Exigir autenticação em dois fatores da equipe

Escolha a política geral de segundo fator e revise exceções individuais.

Onde encontrarMinha conta → Segurança da conta → Política da empresa

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Entre com um administrador autorizado.
  2. Escolha opcional, obrigatório para administradores ou obrigatório para toda a equipe.
  3. Salve a política.
  4. Para uma exigência individual, edite o usuário em Administração → Usuários e marque Exigir autenticação em dois fatores.
  5. Oriente os usuários a configurar o autenticador e guardar os códigos de recuperação.

Resultado esperado

O sistema exige a configuração de segurança para as contas abrangidas.

Observações importantes

  • Não compartilhe sementes de autenticador nem códigos de recuperação entre usuários.
  • A exigência pode impedir a entrada nos atendimentos até o usuário concluir a configuração.

Se precisar de ajuda

  • Usuário preso na configuração: acompanhe a ativação sem pedir que revele a chave secreta ou os códigos.
Equipe e empresa

Cadastrar e manter etiquetas

Mantenha os cadastros utilizados para organizar os atendimentos.

Onde encontrarAdministração → Etiquetas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Preencha um nome claro e sem duplicar um cadastro existente.
  2. Escolha a cor que identifica a etiqueta.
  3. Marque Cadastro ativo e clique em Adicionar.
  4. Para corrigir um item, clique em Editar, ajuste os campos e use Atualizar.
  5. Para interromper o uso preservando a configuração, desmarque Cadastro ativo e salve.
  6. Use Excluir somente quando o cadastro não for mais necessário e confirme a ação.

Resultado esperado

O cadastro fica disponível conforme seu estado e o uso pela interface.

Observações importantes

  • Cadastros administrativos e uso operacional são etapas distintas.
  • Cadastrar motivo de pausa não representa ativar automaticamente uma pausa de um usuário.

Se precisar de ajuda

  • Item ausente: confira se foi salvo como ativo e atualize a tela.
  • Cadastro duplicado: revise os nomes antes de adicionar outro.
Equipe e empresa

Cadastrar motivos do atendimento

Mantenha os cadastros utilizados para classificar o motivo da solicitação.

Onde encontrarAdministração → Motivos do atendimento

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Preencha um nome claro e sem duplicar um cadastro existente.
  2. Escreva uma descrição que ajude a equipe a escolher o motivo correto.
  3. Marque Cadastro ativo e clique em Adicionar.
  4. Para corrigir um item, clique em Editar, ajuste os campos e use Atualizar.
  5. Para interromper o uso preservando a configuração, desmarque Cadastro ativo e salve.
  6. Use Excluir somente quando o cadastro não for mais necessário e confirme a ação.

Resultado esperado

O cadastro fica disponível conforme seu estado e o uso pela interface.

Observações importantes

  • Cadastros administrativos e uso operacional são etapas distintas.
  • Cadastrar motivo de pausa não representa ativar automaticamente uma pausa de um usuário.

Se precisar de ajuda

  • Item ausente: confira se foi salvo como ativo e atualize a tela.
  • Cadastro duplicado: revise os nomes antes de adicionar outro.
Equipe e empresa

Cadastrar motivos de pausa

Mantenha os cadastros utilizados para padronizar os motivos de pausa da operação.

Onde encontrarAdministração → Controle de pausas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Preencha um nome claro e sem duplicar um cadastro existente.
  2. Preencha os campos adicionais de duração ou descrição quando apresentados pela versão instalada.
  3. Marque Cadastro ativo e clique em Adicionar.
  4. Para corrigir um item, clique em Editar, ajuste os campos e use Atualizar.
  5. Para interromper o uso preservando a configuração, desmarque Cadastro ativo e salve.
  6. Use Excluir somente quando o cadastro não for mais necessário e confirme a ação.

Resultado esperado

O cadastro fica disponível conforme seu estado e o uso pela interface.

Observações importantes

  • Cadastros administrativos e uso operacional são etapas distintas.
  • Cadastrar motivo de pausa não representa ativar automaticamente uma pausa de um usuário.

Se precisar de ajuda

  • Item ausente: confira se foi salvo como ativo e atualize a tela.
  • Cadastro duplicado: revise os nomes antes de adicionar outro.
Equipe e empresa

Cadastrar e manter mensagens rápidas

Prepare textos padronizados e escolha os departamentos que podem utilizá-los.

Onde encontrarAdministração → Mensagens rápidas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Crie uma mensagem rápida com título/nome, atalho e texto conforme o formulário.
  2. Insira apenas variáveis que tenham dados disponíveis no atendimento.
  3. Selecione os setores autorizados; sem seleção, o texto fica disponível para todos.
  4. Salve e confira o item na lista.
  5. Edite quando o procedimento mudar ou use a exclusão para retirar uma resposta obsoleta.
  6. Confira o resultado no editor de uma conversa de homologação.

Resultado esperado

A equipe pode inserir a resposta rápida nas conversas autorizadas.

Observações importantes

  • Revise links, valores e dados variáveis antes do envio.
  • Uma mensagem rápida não substitui aprovação de template WhatsApp.

Se precisar de ajuda

  • Atalho não disponível: confira setor e cadastro ativo.
  • Texto com variável vazia: revise o dado de origem e mantenha uma redação adequada.
Equipe e empresa

Definir o que acontece quando o cliente não responde

Configure prazo e encaminhamento da espera no robô, mantendo a política humana separada.

Onde encontrarAdministração → Empresa → Tempos de inatividade

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Informe o prazo sem resposta do cliente no robô.
  2. Escolha transferir diretamente para atendentes ou usar fluxo/regras individuais.
  3. Para transferência direta, escolha o setor padrão quando o fluxo não definir destino.
  4. Para usar um fluxo por inatividade, selecione um fluxo ativo e publicado.
  5. Revise as regras individuais dos agentes para entender a prioridade.
  6. Salve e homologue um atendimento fictício que fique aguardando resposta.

Resultado esperado

A ausência de resposta aciona a regra configurada quando o prazo e as condições forem atendidos.

Observações importantes

  • O prazo começa após a última mensagem do robô que aguarda resposta; nova mensagem do cliente interrompe a contagem.
  • Fora do expediente, transferência humana pode enviar aviso e manter o contato em fila.
  • Pesquisa de satisfação e atendimentos humanos não seguem a mesma regra de espera do robô.
  • A espera pela identificação de CPF/CNPJ também segue a política aplicável. Nas versões com a correção, ausência de resposta ou tentativas sem sucesso pode encaminhar à equipe preservando o contexto e o destino configurado; o cliente não precisa ficar repetindo indefinidamente o documento.

Se precisar de ajuda

  • Destino indisponível: publique e ative o fluxo.
  • Transferência inesperada: confira a política global antes de alterar apenas o agente.
Equipe e empresa

Configurar a sequência e o prazo da pesquisa

Personalize o encerramento e a avaliação enviada após os atendimentos.

Onde encontrarAdministração → Empresa → pesquisa de satisfação

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Marque Enviar pesquisa automaticamente ao encerrar para habilitar a rotina.
  2. Defina o tempo de inatividade da pesquisa em minutos.
  3. Abra Editar fluxo da pesquisa.
  4. Revise a mensagem inicial de encerramento e adicione etapas de mensagem ou imagem conforme a necessidade.
  5. Para imagens, use PNG ou JPG de até 2 MB; respeite até 10 etapas e 5 MB de imagens no total.
  6. Confira a pergunta final de avaliação e salve.
  7. Homologue o encerramento e consulte o resultado em Indicadores/Relatórios.

Resultado esperado

Os próximos encerramentos usam a sequência configurada e o prazo específico da pesquisa.

Observações importantes

  • O prazo é contado depois do envio da pergunta de nota; mensagens e imagens anteriores não consomem esse tempo.
  • A avaliação padronizada é de 1 a 5 e permite pular.
  • Desativar preserva o conteúdo para futura reativação.
  • Nas versões comerciais a partir de 1.0.29, uma resposta reconhecida como avaliação tardia permanece no atendimento encerrado, sem abrir outro protocolo ou acionar a IA.
  • Um pedido novo de ajuda continua sendo tratado como atendimento. A proteção para avaliação tardia não significa ignorar qualquer mensagem após o encerramento.

Se precisar de ajuda

  • Sem nota: o cliente pode ter pulado ou o prazo pode ter terminado.
  • Sequência antiga: alterações valem para novos encerramentos.
Equipe e empresa

Editar departamentos e entender os bloqueios de exclusão

Atualize o nome, os prazos e o vínculo IXC; preserve setores que já têm histórico ou configurações.

Onde encontrarConfigurações → Departamentos → Editar / Excluir

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Na lista de departamentos, localize o setor e clique em Editar. Essas ações estão documentadas a partir da versão 0.45.11.
  2. Confira o nome e os prazos. O formulário de edição usa segundos: 5 minutos correspondem a 300 segundos; 1 hora corresponde a 3600 segundos.
  3. Se utilizar o vínculo, informe o ID do setor no IXC. Deixe vazio quando não for aplicável.
  4. Clique em Salvar alterações e confira o retorno Departamento atualizado.
  5. Para um setor sem uso que realmente deva ser removido, clique em Excluir, leia o nome e a confirmação e só então confirme Excluir departamento.
  6. Se a exclusão for bloqueada por vínculos, mantenha o cadastro e revise sua organização com o administrador. Não apague histórico para liberar a exclusão.

Resultado esperado

O cadastro é atualizado. A exclusão só é aceita quando o setor não possui vínculos que precisam ser preservados.

Observações importantes

  • A lista apresenta primeira resposta em minutos e resolução em horas; a edição usa segundos. Confira a unidade indicada em cada tela.
  • A exclusão exige permissão e é bloqueada por atendimentos, usuários, fluxos, versões publicadas e outras configurações vinculadas.
  • O horário humano continua no calendário geral. Editar SLA não altera os turnos.
  • O campo ID do setor no IXC vincula um identificador; não cria um setor no ERP.

Se precisar de ajuda

  • Prazo rejeitado: confira unidade, mínimo e máximo mostrados no campo.
  • Exclusão recusada: leia a indicação de vínculo; prefira editar o cadastro para preservar o histórico.
  • Editar ou Excluir ausente: confira versão instalada e permissões.
Equipe e empresa

Configurar a capacidade dos atendentes

Limite a quantidade de conversas recebidas pela distribuição automática.

Onde encontrarConfigurações → Empresa → Distribuição → Capacidade dos atendentes

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Com uma conta de administrador, abra Empresa → Distribuição e confira os limites atuais.
  2. Marque Ativar limites na distribuição automática e informe o limite padrão por atendente.
  3. Se desejar, marque Não contar conversas aguardando o cliente. Leia a explicação antes de ativar.
  4. Abra Limites individuais dos atendentes. Deixe em branco para usar o padrão da empresa ou informe um valor específico.
  5. Use Salvar limites e confira a confirmação. Os valores serão considerados nas próximas distribuições automáticas.
  6. Acompanhe a fila e o volume por atendente para avaliar se os limites atendem à operação.

Resultado esperado

Novas distribuições consideram os limites configurados e mantêm os excedentes na fila.

Observações importantes

  • Requer o módulo de capacidade dos atendentes liberado na licença e uma conta administrativa.
  • Os campos aceitam números inteiros de 0 a 1000. Zero significa sem limite, não bloqueio de recebimento.
  • Quando conversas aguardando o cliente não são contadas, uma resposta enviada pelo atendente pode liberar a vaga. Notas internas e mensagens com falha não liberam vagas.
  • Se o cliente responder, a conversa volta a contar e mantém seu responsável, mesmo que a pessoa já tenha atingido o limite.
  • Alterar a capacidade não redistribui atendimentos existentes nem impede assumir manualmente. Horários, presença e demais regras de distribuição continuam valendo.

Se precisar de ajuda

  • Aba Distribuição ausente: confira a licença e sua permissão.
  • Fila não diminui: confira também usuários ativos, presença, setores e horário geral.
  • Quantidade acima do limite: confira retornos de clientes, atendimentos anteriores e atribuições manuais antes de tratar como erro.
Gestão e qualidade

Consultar indicadores e desempenho da equipe

Acompanhe a operação e escolha a aba adequada para equipe, WhatsApp ou cobranças IXC.

Onde encontrarMenu → Indicadores e relatórios

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Indicadores e relatórios e escolha Visão gerencial, Atendimentos, Atendentes, Telefonia, WhatsApp ou Envios de cobrança IXC, conforme os recursos e acessos disponíveis.
  2. Nas visões operacionais, escolha período inicial, período final e setor; use Atualizar e confira o intervalo aplicado.
  3. Na Visão gerencial, consulte status, movimento, média por atendente e alertas de SLA. Na aba Atendimentos, confira evolução e satisfação.
  4. Na aba Atendentes, consulte ranking, volume, espera média e atendimento médio. Abra a conversa relacionada a um alerta para revisar o caso.
  5. Na aba WhatsApp, selecione número e período próprios; use Atualizar volumes ou a consulta separada de custos na Meta.
  6. Em Envios de cobrança IXC, selecione Um dia ou Um período e filtre cliente ou protocolo e status.
  7. Compare indicadores apenas depois de conferir período, fuso horário, canal e acesso por setor. Consulte o guia de cada aba para interpretar seus números.

Resultado esperado

Você obtém a visão operacional permitida para sua conta e seus filtros.

Observações importantes

  • As visões operacionais e o histórico de cobranças têm atualização periódica enquanto abertos. A consulta de custos na Meta exige a ação correspondente na aba WhatsApp.
  • A aba WhatsApp usa número, período e referência UTC próprios. O histórico de cobranças IXC filtra a data de envio no horário de Recife.
  • Histórico encerrado de canal desativado pode permanecer no relatório; isso não significa que o canal esteja recebendo novos atendimentos.
  • Telefonia depende de eventos de uma integração configurada. A existência da aba não comprova que um PABX já esteja conectado.
  • A presença das abas depende da versão instalada, dos módulos habilitados e das permissões da conta.

Se precisar de ajuda

  • Números diferentes da fila: confira período, setor, status e histórico encerrado.
  • Sem dados: verifique acesso e intervalo antes de concluir que houve falha.
Gestão e qualidade

Tratar avaliações baixas e registrar retorno

Acompanhe a nota do cliente e organize a recuperação de uma experiência ruim.

Onde encontrarIndicadores e relatórios → Satisfação / retornos

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Filtre o período e o setor na área de relatórios.
  2. Consulte a distribuição das avaliações.
  3. Abra a lista de retornos associados às notas baixas.
  4. Leia o protocolo e o histórico antes de entrar em contato.
  5. Use os campos disponíveis para registrar responsável, situação e resultado do retorno.
  6. Salve e confira se a pendência foi atualizada.

Resultado esperado

A equipe acompanha a revisão das experiências que exigem retorno.

Observações importantes

  • Notas de 1 a 3 podem abrir retorno no sistema.
  • Uma pesquisa sem resposta não é uma nota zero.
  • Entrar em contato pelo WhatsApp pode exigir HSM e deve respeitar o contexto e as regras do canal.

Se precisar de ajuda

  • Sem avaliação: confira se houve resposta dentro do prazo.
  • Retorno ainda pendente: confira o salvamento da situação e do resultado.
Gestão e qualidade

Revisar alertas de qualidade do atendimento

Analise evidências antes de confirmar uma falha e registre a conclusão humana.

Onde encontrarAdministração → Operação inteligente → Qualidade do atendimento

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a lista de achados e selecione o protocolo.
  2. Leia os motivos e evidências apresentados.
  3. Compare as evidências com o contexto do atendimento.
  4. Defina situação: em revisão, falha confirmada, falso positivo ou tratada, conforme a análise.
  5. Preencha responsável, prazo e conclusão.
  6. Salve revisão e acompanhe os itens ainda abertos.

Resultado esperado

O achado recebe uma avaliação humana rastreável.

Observações importantes

  • A detecção é um alerta; não atribui automaticamente nota ao atendente.
  • Um falso positivo deve ser registrado como tal, com explicação objetiva.

Se precisar de ajuda

  • Registro alterado por outra pessoa: atualize antes de salvar novamente.
  • Evidência insuficiente: mantenha em revisão até conferir o atendimento.
Gestão e qualidade

Gerenciar oportunidades no funil comercial

Registre contatos, próximos passos e evolução da contratação.

Onde encontrarAdministração → Operação inteligente → Funil comercial

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Crie uma oportunidade com título e dados do contato.
  2. Informe origem, responsável e próximo passo.
  3. Escolha a etapa compatível: lead, viabilidade, viável, proposta, aceite, instalação agendada, instalado ou perdido.
  4. Preencha a referência do cliente IXC quando houver um vínculo confirmado.
  5. Atualize a situação como aberta, ganha ou perdida.
  6. Registre motivo de perda quando aplicável e salve.
  7. Revise os próximos passos da equipe periodicamente.

Resultado esperado

A oportunidade fica organizada com etapa e responsável.

Observações importantes

  • Mover para instalação agendada não cria por si só uma OS ou uma agenda externa.
  • Etapas devem representar fatos confirmados e seguir o procedimento comercial da empresa.

Se precisar de ajuda

  • Oportunidade divergente: confira o histórico interno e o último responsável.
  • Conflito de edição: carregue a revisão mais recente.
Gestão e qualidade

Registrar e acompanhar tarefas internas

Organize execução, prazo, responsável e resultado de atividades da operação.

Onde encontrarAdministração → Operação inteligente → Tarefas internas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Crie uma tarefa e informe título e tipo.
  2. Defina responsável, prazo e observações.
  3. Use uma chave de idempotência se a operação exigir identificação específica; quando vazia, a tela permite geração automática.
  4. Atualize a situação para pendente, em execução, concluída, cancelada ou falhou.
  5. Preencha o resultado e salve.
  6. Reabra o item para conferir a revisão registrada.

Resultado esperado

A tarefa fica registrada para acompanhamento interno.

Observações importantes

  • Este cadastro prepara e documenta atividades; não envia mensagens externas automaticamente.
  • Marcar como concluída deve refletir uma execução realmente conferida.

Se precisar de ajuda

  • Conflito de edição: atualize o item e preserve a informação registrada por outra pessoa.
Gestão e qualidade

Usar o discador e configurar a telefonia

Use o discador do dispositivo e diferencie essa ação da API para um PABX externo.

Onde encontrarMenu → Telefone; Integrações → Telefonia

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Como administrador, abra Integrações → Telefonia.
  2. Ative a integração e marque Exibir botão Ligar nos atendimentos, se desejar.
  3. Salve a configuração.
  4. Como atendente, abra Telefone, localize o contato e use Copiar ou Ligar.
  5. Na conversa, use Ligar quando houver um telefone válido e a opção estiver habilitada.
  6. Escolha o aplicativo de telefone ou softphone configurado no seu dispositivo.

Resultado esperado

O número é encaminhado ao discador do aparelho.

Observações importantes

  • O botão Ligar abre o aplicativo de telefone ou softphone configurado no dispositivo; não instala uma central VoIP dentro do Omnichannel.
  • Separadamente, a API de telefonia pode receber eventos e histórico e trocar comandos com um conector externo homologado.
  • Cadastrar provedor, ramal, fila ou intenção de uso em Operação inteligente não comprova que o conector já está instalado e funcionando.
  • Histórico e indicadores de chamadas dependem de eventos reais do conector. Não deduza que uma ligação foi completada apenas porque o discador abriu.

Se precisar de ajuda

  • Nenhum aplicativo abre: configure um programa que aceite links tel: no dispositivo.
  • Botão ausente: confira licença, ativação e telefone válido.
Gestão e qualidade

Consultar mensagens e custos aproximados do WhatsApp

Compare os registros do Omnichannel com os custos disponíveis na Meta, sem tratar dados ausentes como custo zero.

Onde encontrarMenu → Indicadores e relatórios → WhatsApp

Antes de começar

  • Use uma conta com permissão para consultar relatórios.
  • Confira se a versão instalada inclui a aba WhatsApp.

Passo a passo

  1. Abra a aba WhatsApp e selecione o número que deseja consultar. Confira nome e telefone; cada número tem seu próprio filtro.
  2. Escolha Últimos 7 dias, Últimos 30 dias ou Últimos 90 dias. Use Atualizar volumes para consultar novamente os registros locais.
  3. Leia separadamente Recebidas dos clientes, Enviadas pela empresa, Entregues, Lidas, Com falha e Aguardando envio. Esses indicadores descrevem etapas diferentes, não parcelas que devem ser somadas.
  4. Em Classificação de cobrança, confira Cobradas, Isentas e Sem classificação. A tabela mostra as categorias informadas pela Meta e o gráfico compara mensagens enviadas e recebidas por dia.
  5. Para obter o custo disponível na Meta, use Consultar custos na Meta. Confira valor, moeda, horário da consulta e eventual aviso; essa consulta é separada da atualização dos volumes locais.
  6. Leia a seção de franquia sem deduzir um saldo a partir do total de mensagens isentas. Quando aparecer Não confirmado pela Meta, o sistema não tem confirmação do saldo oficial.
  7. Confira o período em UTC no rodapé. Se estiver usando o canal de demonstração, observe o aviso de dados fictícios antes de interpretar os números.

Resultado esperado

Você identifica o movimento do número, a cobertura da classificação de cobrança e o custo aproximado que pôde ser confirmado.

Observações importantes

  • Recurso do pacote comercial 1.0.61-pilot. A disponibilidade no cliente depende da publicação e instalação da versão, da licença e das permissões; a documentação não instala o recurso.
  • Os volumes locais respeitam o acesso do usuário às conversas. A consulta de custo agregado exige acesso administrativo; ela não deve revelar o movimento de outros setores a uma conta restrita.
  • Não informado, Sem classificação e Não confirmado pela Meta significam ausência de confirmação. Nenhum desses estados equivale a gratuidade ou saldo zero.
  • Dados parciais, moeda ausente ou falha de consulta mantêm o total de custo indisponível. Não há conversão automática para reais.
  • O valor da Meta é aproximado e sujeito à consolidação. Ele não inclui consumo de IA nem taxas adicionais de outros fornecedores.
  • Os registros locais podem não cobrir envios anteriores à coleta ou realizados em outros sistemas. Por isso, o total local não precisa coincidir com a consolidação da Meta.
  • A aba WhatsApp usa seus próprios filtros e atualização de volumes. O intervalo de atualização das outras abas de indicadores não significa consultas automáticas de custo na Meta.
  • Um canal identificado como demonstração contém dados fictícios. Consultar seus exemplos não representa mensagens enviadas nem cobrança real.

Se precisar de ajuda

  • Nenhum número disponível: confira a conexão e o acesso aos canais. Um número inativo pode aparecer com essa indicação para consulta do histórico.
  • Falha ao carregar: use Tentar novamente e confira o aviso. Erro de consulta não deve ser interpretado como ausência de mensagens.
  • Custo indisponível: leia o motivo apresentado, como permissão, credencial, retorno parcial ou indisponibilidade da Meta.
  • Diferença em relação a outro relatório: confira número, período, fuso horário, visibilidade por setor e sistemas que também utilizam o número.
Gestão e qualidade

Entender a franquia e os custos do WhatsApp

Diferencie mensagens de serviço, saldo confirmado e custos da Meta para interpretar o relatório.

Onde encontrarIndicadores e relatórios → WhatsApp → Franquia de mensagens de serviço

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Selecione o número e leia a franquia de mensagens de serviço exibida na aba WhatsApp.
  2. Confira a unidade: a regra da Meta consultada em 07/10/2026 prevê, desde 01/10/2026, as primeiras 1.000 mensagens de serviço por número empresarial a cada mês sem cobrança dessa categoria. Não são 1.000 conversas nem uma franquia geral de todos os templates.
  3. Leia o saldo disponível. Se o sistema mostrar Não confirmado pela Meta, não subtraia os volumes locais para criar um saldo oficial.
  4. Use Consultar custos na Meta para obter o valor disponível e confira a moeda e os avisos de consolidação.
  5. Para conferir a cobrança final, use os dados de faturamento da Meta ou do fornecedor responsável. Consulte a referência oficial antes de planejar novos custos.

Resultado esperado

Você entende o que a franquia cobre e reconhece quando o relatório ainda não pode confirmar saldo ou custo.

Observações importantes

  • Segundo a seção de preços datada da FAQ oficial, a Meta passa a cobrar mensagens de serviço a partir da 1.001ª por número no mês, conforme as tarifas publicadas.
  • O relatório não fixa uma tarifa em reais. Categoria, mercado e regras vigentes precisam ser conferidos na fonte oficial.
  • Mensagens isentas no registro local não equivalem necessariamente ao consumo da franquia. O número pode ser utilizado por outros sistemas e ter outras condições de isenção.
  • Custo indisponível não significa custo zero. Taxas de fornecedores e uso de IA não estão incluídos no valor aproximado exibido para a Meta.
  • A disponibilidade do envio sem template é verificada na conversa e não é determinada pelo saldo da franquia.

Se precisar de ajuda

  • Saldo não confirmado: consulte o faturamento oficial; não trate o contador local como extrato completo do número.
  • Textos antigos mencionam conversas: confira a regra com vigência explícita na seção de preços da Meta. Esta orientação foi revista em 07/10/2026.
  • Valores diferentes: compare número, período, moeda e possíveis cobranças adicionais do fornecedor.

Referências oficiais

Gestão e qualidade

Consultar o histórico de envios de cobrança IXC

Filtre cobranças por data, cliente e status para localizar o envio e consultar sua mensagem ou motivo de falha.

Onde encontrarMenu → Indicadores e relatórios → Envios de cobrança IXC

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Envios de cobrança IXC com uma conta autorizada para esse relatório.
  2. Em Consultar, escolha Um dia ou Um período e preencha as datas. O filtro usa a data de envio no horário de Recife.
  3. Use Buscar cliente ou protocolo para pesquisar nome, telefone ou protocolo. Escolha um Status quando quiser restringir a lista.
  4. Leia os totais do filtro e confira Cliente, Data e hora, Modelo e Status na linha do envio.
  5. Abra Ver mensagem para consultar o texto disponível e o motivo informado quando houve falha.
  6. Se houver um protocolo ou Ver conversa na coluna Atendimento, use-o para abrir a conversa vinculada. Aguardando resposta indica que o envio ainda não tem esse vínculo.
  7. Use Anterior e Próxima para percorrer as páginas. Em tela pequena, role a tabela horizontalmente para alcançar Detalhes.

Resultado esperado

Você localiza o envio de cobrança e diferencia fila de envio, envio realizado, entrega, leitura e falha.

Observações importantes

  • A aba depende de permissão específica para consultar cobranças; ter acesso a outros indicadores não garante acesso a ela.
  • Envios automáticos não abrem um atendimento por si só. Quando o cliente responde, a cobrança pode ser vinculada à conversa.
  • O relatório consulta novamente os dados enquanto a tela está aberta. Essa consulta não reenvia a mensagem.
  • Este filtro usa o horário de Recife. A aba WhatsApp apresenta seu período em UTC; compare os intervalos antes de esperar totais iguais.
  • Sem atendimento ou Aguardando resposta não significam, isoladamente, erro de envio. Confira o Status e os detalhes.
  • O histórico de cobrança não é o extrato financeiro da Meta nem a confirmação de pagamento do cliente.

Se precisar de ajuda

  • Período rejeitado: preencha as datas e mantenha a data final igual ou posterior à inicial.
  • Nenhum envio encontrado: confira data, busca e status antes de concluir que a integração não enviou.
  • Falha ao carregar: use Tentar novamente. Para acesso negado, solicite revisão da permissão.
  • Falha no envio: reúna horário, modelo e motivo apresentado para o suporte; consultar a linha não corrige nem reenvia a cobrança.
Integrações e backups

Links externos para configurar suas integrações

Abra o painel certo para criar chaves, autorizar contas, administrar modelos e consultar consumo. Depois, conclua a configuração no Omnichannel.

Onde encontrarWiki → Integrações e backups → Links externos; Omnichannel → Configurações → Integrações

Campos e opções

CampoComo preencher
IXC / SGPAbra o endereço do ERP da sua empresa. Os links abaixo levam às instruções oficiais para a integração.
FSNET IAA chave é emitida por empresa na gerência do fornecedor. O administrador do cliente recebe a credencial para sua própria instalação.
Hermes AgentSolicite ao administrador a URL e a autenticação do servidor Hermes. Não use a URL de outra instalação.
PABX / HTTP / Webhooks / SFTPUse o endereço fornecido pelo responsável pelo serviço. PABX exige adaptador e homologação do fornecedor.
Chat do siteA configuração é concluída no Omnichannel e no administrador do seu site ou WordPress; não há token de uma rede social para criar.
Integrações e backups

Configurar e revisar a integração IXC

Cadastre o endereço e o token da empresa e ajuste as preferências de consulta.

Onde encontrarConfigurações → Integrações → IXC Soft

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Tenha acesso administrativo ao Omnichannel e ao IXC da própria empresa.
  • Separe o endereço do IXC e um token de usuário API com as permissões necessárias. O domínio de login é o da sua instalação, não o site da documentação.

Passo a passo

  1. Abra o IXC pelo endereço da sua empresa e prepare o usuário API conforme o guia Gerar token no IXC.
  2. No Omnichannel, abra IXC Soft e use Editar informações. Preencha URL e Token; a base da API tem o formato https://SEU-IXC/webservice/v1/.
  3. Cole o token completo fornecido pelo IXC. Não substitua pela senha de login nem converta o token para Base64 antes de colar.
  4. Revise Usar o IXC no contexto do cliente durante os atendimentos e as demais preferências necessárias à operação.
  5. Confira o período de notas fiscais e o tempo limite da consulta. Use Salvar IXC e leia o resultado.
  6. Homologue a consulta com um cadastro autorizado, conferindo nome, contrato, faturas e logins conforme as permissões concedidas.
  7. Se o IXC também enviará cobranças pelo Omnichannel, configure a ponte separadamente. Ela tem endereço e token próprios, na direção inversa.

Resultado esperado

O painel passa a consultar o IXC com a credencial configurada e suas permissões.

Observações importantes

  • O token salvo não é devolvido ao navegador. Ao editar, deixar o campo vazio preserva a credencial atual conforme a indicação da tela.
  • IXC → Omnichannel e Omnichannel → IXC são integrações diferentes. O token da ponte não substitui o token do usuário API do IXC.
  • Alterar e-mail ou senha do usuário API no IXC pode alterar seu token. Atualize a integração e confira o resultado se isso ocorrer.
  • As permissões do grupo e as redes permitidas no IXC precisam incluir as ações e o servidor da sua instalação. Não use um IP de outra empresa por copiar um exemplo.
  • Desbloqueio, financeiro e OS dependem de permissões e regras do ERP. A consulta não realiza baixa de pagamento.

Se precisar de ajuda

  • Erro de autenticação: confira token e permissões no IXC.
  • Timeout: confira endereço e conectividade com o responsável técnico.

Referências oficiais

Integrações e backups

Preparar a ponte de integração do IXC

Disponibilize os canais e modelos oficiais ao IXC dentro do escopo configurado.

Onde encontrarIntegrações → IXC Soft → Integração Omnichannel do IXC

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira o modo e os limites da ponte disponíveis nesta instalação.
  2. Copie a URL apresentada para cadastrar no IXC.
  3. Informe o número autorizado para homologação quando a configuração exigir essa restrição.
  4. Gere a credencial pelo comando da tela e copie-a no momento da exibição.
  5. Entregue-a ao responsável pelo cadastro no IXC por meio reservado.
  6. Homologue exclusivamente com o destinatário autorizado e confira os resultados antes de solicitar uma ampliação do uso.
  7. Depois da homologação, siga o guia de liberação de produção para revisar os controles de envio e o padrão do IXC.

Resultado esperado

O IXC pode usar a ponte conforme a credencial, os recursos e o destinatário permitidos.

Observações importantes

  • A credencial aparece uma única vez.
  • No modo restrito de homologação, outros destinatários são recusados.
  • Este cadastro não deve ser confundido com copiar credenciais de outro sistema.
  • Liberar produção permite destinatários além do teste; Bloquear envio interrompe os envios. Confira o modo exibido antes de alterar esses controles.
  • Nas versões com o histórico de cobranças, envios automáticos podem ficar em Indicadores e relatórios → Envios de cobrança IXC sem abrir protocolo. Quando o cliente responde, o histórico é associado à conversa; um atendimento aberto pode ser reutilizado.
  • Conferências da fatura podem impedir cobranças pagas, canceladas ou sem identificação segura. Consulte o motivo antes de repetir.

Se precisar de ajuda

  • Destinatário recusado: confira a restrição de homologação, sem desativá-la apenas para concluir um teste.
  • Credencial perdida: utilize o procedimento de renovação apresentado pelo administrador.

Referências oficiais

Integrações e backups

Configurar a integração SGP

Conecte a API pública do SGP e confira o teste e os registros.

Onde encontrarConfigurações → Integrações → SGP

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Confira a licença SGP no Omnichannel.
  • Tenha o endereço da sua instalação SGP e a credencial autorizada pelo seu administrador. Não existe um endereço único de login para todos os provedores.

Passo a passo

  1. Abra o SGP pelo domínio usado pela sua empresa. Solicite ao administrador o Token e o nome do App com as permissões necessárias.
  2. No Omnichannel, abra SGP → Editar informações e preencha URL do seu SGP.
  3. Em Forma de autenticação, selecione Token + App para a integração de produção. Use Usuário + senha (Basic/demo) apenas se esse ambiente efetivamente disponibilizar esse método.
  4. Preencha Nome do App e Token, ou Usuário e Senha, conforme a modalidade escolhida.
  5. Confira tempo limite, consultas e auditoria disponibilizados no formulário. Use Salvar SGP e depois Testar conexão.
  6. Consulte Baixar logs quando precisar diagnosticar a conexão. Desconectar SGP interrompe a integração e deve corresponder à decisão da operação.

Resultado esperado

A integração fica configurada e o teste informa a disponibilidade da API.

Observações importantes

  • Token e senha permanecem protegidos. Ao editar, siga a indicação da tela para preservar a credencial existente.
  • O link de documentação não é a URL a preencher no campo URL do seu SGP; use o domínio contratado pela empresa.
  • Uma conexão válida não comprova equivalência de todas as funções IXC. Homologue as consultas e ações efetivamente disponíveis na sua versão.

Se precisar de ajuda

  • Falha no teste: confira URL, modalidade de autenticação e autorização do App.
  • Senha/token não exibidos após salvar é comportamento esperado.

Referências oficiais

Integrações e backups

Configurar um conector HTTP

Prepare o conector HTTP e confira seu estado antes de utilizá-lo.

Onde encontrarConfigurações → Integrações → HTTP

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Obtenha com o responsável pelo sistema externo a URL autorizada e a forma de autenticação.
  2. Informe Nome da integração e URL de destino. Escolha Sem autenticação, Bearer token, Basic (valor já codificado) ou Chave em cabeçalho conforme o contrato da API.
  3. Para Chave em cabeçalho, preencha também Nome do cabeçalho. Informe a credencial no campo protegido e confira o tempo limite.
  4. Salve e use Testar conexão. O teste realiza uma consulta GET na URL configurada.
  5. Confira código e horário nos registros. Homologue separadamente a operação que consumirá essa API.

Resultado esperado

A configuração fica salva e o teste informa o resultado da conexão.

Observações importantes

  • O endereço depende da API da empresa; não há um painel de chaves universal para HTTP.
  • O teste exige uma URL que aceite GET. Uma API que espera POST, parâmetros ou corpo específicos pode recusar esse teste mesmo estando acessível.
  • Salvar e testar esse cadastro não publica um fluxo nem habilita automaticamente um executor HTTP genérico no construtor.
  • Use o campo protegido para a credencial, sem incluí-la na URL.

Se precisar de ajuda

  • Falha de conexão: confira endereço, credenciais, licença e último teste.
  • Não compartilhe tokens ou senhas ao abrir um chamado de suporte.
Integrações e backups

Cadastrar webhooks de integração

Prepare o conector Webhooks e confira seu estado antes de utilizá-lo.

Onde encontrarConfigurações → Integrações → Webhooks

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Obtenha com o responsável pelo sistema receptor uma URL HTTPS que aceite o evento de teste e o formato combinado.
  2. Informe Nome da integração, URL de destino e Eventos (um por linha), conforme o formulário.
  3. Preencha o segredo quando a integração usar assinatura e ajuste o tempo limite.
  4. Salve e use Testar conexão. O Omnichannel envia uma requisição POST real com o evento integration.test para a URL configurada.
  5. Confira o recebimento no sistema de destino. Quando há segredo, valide a assinatura HMAC-SHA256 enviada no cabeçalho X-Omnichannel-Signature.
  6. Confirme separadamente quais eventos operacionais estão vinculados ao cadastro utilizado pela instalação. O recebimento do teste não comprova a entrega de todos esses eventos.

Resultado esperado

A configuração fica salva e o teste informa o resultado da conexão.

Observações importantes

  • Webhooks usam o endereço do sistema receptor da empresa. Não existe um painel externo único para cadastrar todos os destinos.
  • O teste envia integration.test; não utiliza uma mensagem real de cliente.
  • Este cadastro de saída é diferente do webhook que recebe mensagens e status da Meta ou do Telegram.
  • Quando a instalação também usa Administração → Webhooks, confira com o responsável qual cadastro efetivamente entrega os eventos operacionais.

Se precisar de ajuda

  • Falha de conexão: confira endereço, credenciais, licença e último teste.
  • Não compartilhe tokens ou senhas ao abrir um chamado de suporte.
Integrações e backups

Configurar SMTP e enviar o teste de conexão

Prepare o conector SMTP / e-mail e confira seu estado antes de utilizá-lo.

Onde encontrarConfigurações → Integrações → SMTP

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Obtenha com o serviço de e-mail da empresa o servidor, a porta, o usuário e o método de autenticação aceito.
  2. No Omnichannel, informe Servidor, Porta e Usuário. Escolha STARTTLS ou SSL/TLS conforme a configuração desse serviço.
  3. Preencha a credencial, E-mail remetente e Nome do remetente. O formulário atual utiliza usuário e credencial; não oferece login OAuth para SMTP.
  4. Para validar um envio, preencha Destinatário do teste com um endereço da própria equipe autorizado a recebê-lo.
  5. Salve e use Testar conexão. Com remetente e destinatário preenchidos, o teste envia um e-mail; confira o resultado e o recebimento.
  6. Se não houver destinatário/remetente de teste, o resultado pode confirmar somente o servidor e a autenticação. Isso não comprova entrega de e-mail.

Resultado esperado

A configuração fica salva e o teste informa o resultado da conexão.

Observações importantes

  • SMTP é um protocolo: o painel e as credenciais dependem do serviço de e-mail contratado pela empresa.
  • Para Google, senhas de app exigem verificação em duas etapas e podem não estar disponíveis conforme a conta ou a política da organização. Não use uma senha comum por tentativa se o provedor exigir outro método.
  • Se o provedor exigir apenas OAuth, este formulário de usuário/credencial não completa essa integração; confirme uma alternativa compatível com seu administrador.
  • Salvar SMTP não transforma campanhas WhatsApp em campanhas de e-mail nem habilita uma caixa de entrada IMAP.

Se precisar de ajuda

  • Falha de conexão: confira endereço, credenciais, licença e último teste.
  • Não compartilhe tokens ou senhas ao abrir um chamado de suporte.

Referências oficiais

Integrações e backups

Configurar SFTP para receber backups

Prepare o conector SFTP e confira seu estado antes de utilizá-lo.

Onde encontrarConfigurações → Integrações → SFTP

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Solicite ao responsável pelo servidor de destino o endereço, a porta, o usuário, a credencial e a pasta remota para backups.
  2. Obtenha também a identidade do servidor no formato SHA256 por um canal confiável com esse responsável.
  3. No Omnichannel, preencha os campos e use Salvar configuração.
  4. Use Testar conexão para conferir se o endereço responde como serviço SSH/SFTP. Esse teste não autentica o usuário nem grava arquivos.
  5. Configure uma rotina com destino SFTP e valide um envio de backup autorizado. Confira o arquivo no destino para comprovar permissão, identidade e gravação.
  6. Defina com o responsável pelo SFTP a retenção remota, o espaço disponível e o acesso para recuperação.

Resultado esperado

O servidor de destino fica configurado; um envio validado comprova que o backup chegou à pasta prevista.

Observações importantes

  • Não existe um painel público único para SFTP. Use o servidor e a conta fornecidos pela sua empresa.
  • Testar conexão confere acesso de rede e identificação do protocolo SSH. Resultado positivo não prova credencial, pasta ou permissão de gravação.
  • O envio de backup verifica a identidade SHA256 do servidor. Não troque essa identidade apenas para ignorar uma divergência.
  • A retenção da tela Backups não aplica a política de limpeza do SFTP; ela continua sob responsabilidade do destino.

Se precisar de ajuda

  • Falha de conexão: confira endereço, credenciais, licença e último teste.
  • Não compartilhe tokens ou senhas ao abrir um chamado de suporte.
Integrações e backups

Conectar Google Drive para backups

Prepare o conector Google Drive e confira seu estado antes de utilizá-lo.

Onde encontrarConfigurações → Integrações → Google Drive

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. No Google Cloud, selecione o projeto da empresa e habilite a Google Drive API. Configure a identidade e o consentimento OAuth apropriados à organização.
  2. Em Clientes OAuth, crie ou revise um cliente do tipo aplicação Web. Separe o ID do cliente e a chave secreta para configurar o Omnichannel.
  3. Abra Google Drive → Editar informações no Omnichannel. Copie a URL de retorno autorizada mostrada e cadastre exatamente esse endereço no cliente OAuth do Google Cloud.
  4. Preencha ID do cliente OAuth e Chave secreta OAuth. Salve a configuração e use a conexão com o Google.
  5. Escolha a conta da empresa autorizada para os backups e conclua o consentimento. Ao retornar, confira a conta e a pasta indicadas.
  6. Use Testar conexão. O teste consulta a conta e a pasta; se necessário, a integração cria sua pasta de backups.
  7. Configure a rotina de backup ou utilize Enviar último backup quando houver uma cópia validada. Confira o arquivo no Drive para confirmar o envio.

Resultado esperado

A configuração fica salva e o teste informa o resultado da conexão.

Observações importantes

  • A conexão utiliza OAuth com renovação de acesso. Não é um campo para colar uma chave de API genérica nem a senha da conta Google.
  • O tipo do cliente é aplicação Web. Exemplos de cliente Desktop App da documentação Google não correspondem a este formulário.
  • A URL de retorno deve coincidir exatamente com a mostrada pelo Omnichannel, inclusive domínio, protocolo e caminho.
  • A autorização não agenda backups por si só. Configure também a rotina e a retenção pretendidas.
  • O teste pode criar a pasta e renovar credenciais. A comprovação de upload depende de um arquivo efetivamente enviado.

Se precisar de ajuda

  • redirect_uri_mismatch: compare a URL autorizada no Google com o campo de retorno do Omnichannel.
  • Acesso negado no consentimento: confira o projeto, a conta, a audiência e a política Google da organização.
  • Conexão válida sem backups: confira a rotina, a existência da cópia local e o resultado do último envio.

Referências oficiais

Integrações e backups

Agendar backups automáticos

Escolha conteúdo, frequência e destinos para as cópias de segurança.

Onde encontrarAdministração → Rotinas automáticas

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
BancoDump consistente dos dados do PostgreSQL.
ArquivosCódigo e arquivos locais abrangidos pela rotina.
ChavesConfiguração necessária à recuperação de segredos.
CompletoBanco, arquivos e chaves reunidos.
FrequênciaDiária; semanal com dia; mensal com dia de 1 a 28.
DestinosLocal, Google Drive e/ou SFTP configurados.

Passo a passo

  1. Crie ou edite uma rotina.
  2. Escolha banco, arquivos, chaves ou completo.
  3. Selecione frequência diária, semanal ou mensal e configure horário e dia quando solicitados.
  4. Marque um ou mais destinos: local, Google Drive ou SFTP.
  5. Confira as integrações remotas antes de ativar.
  6. Revise a retenção em dias, sabendo que uma política salva em Backups tem prioridade para local/Drive.
  7. Ative e salve a rotina.
  8. Após a execução prevista, confira o último resultado por destino e a cópia na área Backups.

Resultado esperado

O executor da instalação realiza a cópia no horário elegível e registra o resultado.

Observações importantes

  • Rotinas antigas precisam ser salvas para habilitar o novo agendamento.
  • O fuso é o da instalação.
  • Banco inclui os dados armazenados no banco; arquivos externos mantidos apenas por canais não são baixados automaticamente.
  • Chaves contém a configuração necessária à recuperação e requer armazenamento reservado.
  • Backups de servidor podem ser bloqueados em instalações multiempresa.

Se precisar de ajuda

  • Não executou: confira ativação, dia, fuso e serviço executor com o suporte.
  • Um destino falhou: confira o resultado individual; uma cópia local pode ter sido preservada.
Integrações e backups

Consultar cópias locais e do Google Drive

Revise data, tipo, tamanho e condição de retenção dos backups.

Onde encontrarAdministração → Backups

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra a tela com um administrador autorizado.
  2. Escolha Local ou Google Drive.
  3. Clique em Atualizar lista.
  4. Use busca e paginação para localizar a cópia.
  5. Confira nome, data de criação, tamanho e indicação de retenção.
  6. Compare o registro com o último resultado da rotina correspondente.

Resultado esperado

Você localiza as cópias reconhecidas e consulta sua condição.

Observações importantes

  • A tela não exibe credenciais ou o conteúdo dos arquivos.
  • Cópias antigas sem comprovação de origem/conclusão e uploads incompletos podem ficar protegidos.
  • Listar uma cópia não comprova que ela já foi restaurada com sucesso.

Se precisar de ajuda

  • Drive vazio: confira conta, pasta e resultado da integração.
  • Cópia esperada ausente: consulte o resultado da rotina e o destino selecionado.
Integrações e backups

Definir quantas cópias de backup manter

Configure limites independentes para armazenamento local e Google Drive.

Onde encontrarAdministração → Backups → Quantas cópias manter

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira quais cópias estão disponíveis e a necessidade de recuperação da empresa.
  2. Marque Limitar quantidade local se desejar limpeza nesse destino.
  3. Informe de 1 a 365 cópias.
  4. Faça o mesmo para o Drive, com uma quantidade independente.
  5. Leia e marque a confirmação de remoção das cópias excedentes.
  6. Salve e acompanhe a última verificação.
  7. Para suspender esse controle em um destino, desmarque seu limite e salve.

Resultado esperado

O executor mantém as cópias elegíveis mais recentes dentro da quantidade configurada.

Observações importantes

  • Local: cópias excedentes concluídas são removidas definitivamente. Drive: cópias reconhecidas e verificações vão para a lixeira.
  • O limite é global por destino, reunindo tipos de backup.
  • Arquivos desconhecidos ou sem comprovação permanecem protegidos.
  • Esta política, depois de salva, substitui prazos locais por dias; SFTP fica fora desse controle.

Se precisar de ajuda

  • Quantidade aparentemente excedida: confira itens protegidos e última verificação.
  • Falha remota: corrija a integração e aguarde a próxima verificação.
Integrações e backups

Solicitar e conferir uma restauração de backup

Prepare uma recuperação assistida com banco, configuração e arquivos compatíveis.

Onde encontrarBackups → localizar a cópia; responsável técnico → recuperação assistida

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Localize a data e o tipo da cópia que atende à necessidade.
  2. Informe ao responsável técnico o que precisa recuperar e qual o intervalo afetado.
  3. Confirme a disponibilidade da chave de descriptografia, guardada fora do pacote.
  4. Solicite primeiro um ensaio em ambiente isolado, com verificação do arquivo e da compatibilidade.
  5. Confira os resultados esperados no ensaio: acesso, registros e anexos que efetivamente fazem parte da cópia.
  6. Planeje a restauração operacional somente após conhecer o impacto sobre dados posteriores.

Resultado esperado

A recuperação é validada tecnicamente antes de interferir na operação.

Observações importantes

  • Não há botão geral de restauração em produção documentado nesta tela.
  • Cópias novas são criptografadas e precisam de descriptografia.
  • Restaurar o banco não recupera automaticamente mídias externas nem reaplica exclusões feitas depois da cópia.
  • Não coloque chaves de recuperação nesta wiki.

Se precisar de ajuda

  • Cópia não abre: confira chave, verificação e formato com o suporte.
  • Anexo ausente: confirme se ele era local ou dependia de um canal externo.
Integrações e backups

Consultar licença e módulos disponíveis

Confira a licença da instalação e diferencie recurso contratado, permissão da conta e conexão do provedor.

Onde encontrarConfigurações → Atualizações; Configurações → Integrações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Em uma instalação de cliente, abra Configurações → Atualizações e confira domínio, plano, validade e versão apresentados.
  2. Consulte o catálogo de Integrações e os recursos disponíveis na operação.
  3. Se uma opção esperada não aparecer, confira a versão instalada, a licença e o perfil de permissão do usuário.
  4. Solicite ao responsável comercial a revisão do recurso contratado. Um administrador da empresa não altera a licença pela edição do seu próprio perfil.
  5. Depois da alteração autorizada na gerência, aguarde a sincronização e atualize a tela.
  6. Se o recurso está liberado, mas não funciona, confira também a configuração, a credencial e o estado do serviço externo.

Resultado esperado

Você identifica o escopo liberado à instalação.

Observações importantes

  • Licença, permissão e conexão são controles diferentes. Liberar o módulo não conecta uma conta nem autoriza todas as ações de cada usuário.
  • Capacidade dos atendentes, presença e digitação, ações rápidas, agendamento de conversas e central de ajuda pública têm concessões próprias. Sua disponibilidade não é garantida apenas por receber uma versão nova.
  • Um recurso de ERP ou provedor de IA também depende do respectivo módulo principal de Integrações ou Inteligência artificial.
  • A instalação mantém a última licença assinada verificada quando não consegue consultar a central. Login e atendimento humano não são desativados somente por uma falha dessa consulta.
  • Sem licença verificável, módulos opcionais podem ficar indisponíveis. Não tente contornar a licença criando outro usuário.
  • Na matriz de desenvolvimento, Atualizações mostra o histórico instalado; a sincronização da licença continua separadamente.
  • A gerência central é um acesso do operador do serviço, distinto da administração da empresa atendida.

Se precisar de ajuda

  • Opção ausente: confira perfil, versão e recurso contratado.
  • Falha persistente de licença: informe o domínio e a mensagem exibida ao suporte, sem enviar chaves.
Integrações e backups

Consultar e solicitar atualizações da instalação

Leia as notas, confira a elegibilidade e acompanhe uma instalação imediata ou agendada no ambiente de cliente.

Onde encontrarConfigurações → Atualizações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Configurações → Atualizações e confira a versão instalada. Se a tela identificar o ambiente de desenvolvimento, consulte apenas seu histórico instalado.
  2. Em uma instalação de cliente gerenciada, clique em Buscar atualizações para consultar a central. Essa ação não instala nem agenda uma versão.
  3. Leia as notas da versão disponível. Uma versão da Wiki ou um rascunho preparado pelo fornecedor não significa que o pacote já esteja disponível para sua instalação.
  4. Para uma atualização elegível, use Atualizar agora ou escolha data e hora e use Agendar atualização. Confira o horário local apresentado e a confirmação.
  5. Se houver indicação de atualização assistida ou problema de licença, combine o procedimento com o suporte antes de continuar.
  6. Enquanto a solicitação estiver pendente e o comando estiver disponível, use Cancelar atualização para cancelá-la.
  7. Acompanhe validação, backup, download, preparação, ativação e verificação. Se a conexão cair, aguarde a atualização do estado antes de repetir uma solicitação.
  8. Após o resultado final, confira versão, login e atendimentos. Fechar progresso apenas dispensa o resultado exibido; não desfaz a instalação.

Resultado esperado

A solicitação é registrada e o executor informa sucesso ou falha da instalação.

Observações importantes

  • Preparar, publicar e instalar são etapas separadas. A publicação na gerência não instala automaticamente uma versão nos clientes.
  • A oferta depende do canal de distribuição, da licença e da compatibilidade com a versão instalada. Uma versão pode não ser oferecida a todos os clientes ao mesmo tempo.
  • Pacotes e catálogo são autenticados e verificados. Uma recusa de assinatura, download ou compatibilidade deve ser tratada pelo suporte; não force o avanço.
  • A atualização preserva dados e configurações da instalação e cria backup antes de alterar serviços. O banco não é restaurado automaticamente por cima de mensagens recebidas depois do backup.
  • Migrações automáticas dependem de caminhos previamente suportados. A indicação de atualização assistida não deve ser ignorada.
  • Resultados antigos não iniciam uma nova execução ao reabrir a tela. Falha na consulta à central após uma instalação não prova, isoladamente, falha da instalação.

Se precisar de ajuda

  • Sem versão disponível: confira se a instalação já está atualizada, se o pacote foi publicado e se é elegível para sua licença e versão.
  • Na matriz sem botões de buscar ou instalar: esse é o comportamento esperado; consulte Ambientes e versões.
  • Falha de instalação: registre versão, etapa, horário e mensagem exibida. Preserve o estado para análise do suporte, sem reinstalar sobre o ambiente existente.
Integrações e backups

Consultar e baixar erros das integrações

Localize falhas administrativas, interprete os códigos do provedor e reúna o diagnóstico para o suporte.

Onde encontrarConfigurações → Integrações → Registros de erros / Erros das integrações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra Registros de erros no catálogo ou Erros das integrações na configuração do canal. Ver registros em um cartão pode abrir o filtro daquele provedor.
  2. Selecione a integração e o período: últimas 24 horas, 7, 30 ou 90 dias.
  3. Clique em Atualizar e localize a operação pelo horário.
  4. Leia a mensagem e os códigos HTTP da operação e do provedor. Confira código e subcódigo, quando informados.
  5. Abra Dados para diagnóstico e copie a referência do registro e a referência da Meta, quando disponível.
  6. Use Anterior e Próxima para navegar. Baixar esta página exporta somente os registros da página exibida em erros-integracoes.json.
  7. Encaminhe ao suporte o diagnóstico relevante, junto da ação tentada e do horário.

Resultado esperado

Você identifica a falha e obtém uma referência que ajuda o suporte a investigar.

Observações importantes

  • O painel registra falhas de operações administrativas após a implantação do recurso, a partir da versão 0.45.4. Não recupera automaticamente detalhes de erros antigos.
  • Não é um histórico completo das mensagens dos clientes. Corpos de mensagens, anexos e credenciais não são armazenados neste painel.
  • Código, subcódigo e referência da Meta dependem do que o provedor retornou.
  • Baixar esta página não exporta todas as páginas nem corrige o erro.

Se precisar de ajuda

  • Lista vazia: confira período, integração e data da atualização que passou a registrar as falhas.
  • Erro genérico antigo: detalhes podem não ter sido preservados. Informe ao suporte os dados disponíveis.
  • Código externo sem orientação: reúna a referência em vez de trocar credenciais repetidamente.
Integrações e backups

Preparar a integração com um PABX externo

Planeje o conector necessário para trocar eventos, histórico e comandos de telefonia.

Onde encontrarIntegração técnica de telefonia → API e conector externo

Antes de começar

  • Confira a licença de telefonia e a versão instalada.
  • Tenha o fabricante, a versão e o endereço do PABX da empresa. O fornecedor ou responsável técnico precisa confirmar o conector compatível.

Passo a passo

  1. Informe ao responsável técnico qual PABX, versão e recursos a empresa pretende utilizar.
  2. Confirme que existe um conector compatível ou que ele será implementado para a API de telefonia do Omnichannel.
  3. Defina empresa, ramais e capacidades permitidas. O responsável configura a credencial própria e protege seu armazenamento.
  4. Homologue a chegada de eventos e o histórico com uma conta e chamadas de teste autorizadas, sem pressupor que o discador já faça essa integração.
  5. Habilite comandos somente depois de conferir os ramais permitidos, a entrega ao conector e o retorno real do PABX.
  6. Registre os recursos que foram homologados e mantenha desabilitadas as operações ainda não verificadas.

Resultado esperado

O escopo de telefonia fica definido e pode operar pelas funções efetivamente homologadas no conector.

Observações importantes

  • A API padronizada está documentada no pacote comercial 1.0.44 e preservada na base 1.0.67. Ela não é um conector pronto para todos os fabricantes.
  • O PABX continua externo. Não existe um painel universal de credenciais: use o endereço e o método fornecidos pelo administrador da central.
  • O conector precisa traduzir os eventos e comandos entre o PABX e a API do Omnichannel. Essa configuração é trabalho técnico separado.
  • Credenciais são próprias por empresa. Ramais e capacidades permitidas limitam originação, desligamento e transferência quando habilitados.
  • Solicitação aceita ou entregue ao conector não significa ligação concluída. Confira o resultado devolvido pelo PABX.
  • A API não fornece motor SIP ou mídia. Sua presença não comprova discador, gravação, transcrição ou chamadas WhatsApp homologados na instalação.

Se precisar de ajuda

  • Sem histórico: confira se o conector está autorizado e enviando os eventos do PABX.
  • Comando recusado: confira ativação, capacidade e ramal permitidos antes de repetir.
  • Resultado desconhecido: consulte o conector e o PABX; não conclua que a chamada falhou ou terminou só pela ausência do retorno.
Integrações e backups

Distinguir matriz, cliente e versão publicada

Entenda por que a área Atualizações funciona de forma diferente no desenvolvimento e nas instalações de clientes.

Onde encontrarConfigurações → Atualizações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira o ambiente e a versão exibidos na instalação que você está usando.
  2. Na matriz de desenvolvimento, consulte a versão atual e as versões efetivamente instaladas, com suas alterações.
  3. Em uma instalação de cliente, consulte as versões publicadas e elegíveis. Solicite ou agende a instalação somente após ler as notas.
  4. Ao comparar ambientes, registre separadamente versão instalada, pacote comercial e data da conferência.
  5. Se a Wiki descrever um recurso que ainda não aparece, confira sua versão, licença e permissões antes de tratar como defeito.

Resultado esperado

Você distingue a documentação do recurso, sua publicação comercial e a instalação efetiva no ambiente usado.

Observações importantes

  • Desde a mudança de papéis de outubro de 2026, a matriz recebe implantação direta da equipe técnica. Não usa o atualizador comercial de clientes.
  • A tela da matriz mostra somente histórico instalado, sem busca, agendamento, instalação ou avisos de novas versões comerciais. Datas de instalação desconhecidas não são inventadas.
  • Produção e demais clientes recebem pacotes cumulativos pela gerência. Publicar um pacote não solicita sua instalação.
  • Dados, números, integrações e credenciais de clientes não devem ser copiados para a matriz; testes usam dados fictícios e conexões próprias.
  • Um ensaio de atualização comercial exige consumidor de laboratório separado. A matriz atualizada não é, por si só, evidência de atualização de um cliente.

Se precisar de ajuda

  • Histórico diferente do catálogo: o histórico registra o que foi instalado; o catálogo contém ofertas de atualização.
  • Recurso ausente: informe ambiente, versão e mensagem ao suporte, sem enviar credenciais.
Integrações e backups

Acessar a gerência e administrar seus usuários

Use contas individuais para administrar a central comercial, separadamente das contas de atendentes.

Onde encontrarCentral de gerência → Entrar / Usuários / Minha senha

Antes de começar

  • Tenha autorização do operador para acessar a central de gerência.

Passo a passo

  1. Acesse o endereço HTTPS da central fornecido pelo responsável do serviço e entre com seu e-mail e senha.
  2. Se recebeu senha temporária, conclua Definir senha pessoal antes de acessar os recursos administrativos.
  3. Como administrador da gerência, abra Usuários para criar ou editar uma conta e escolher Administrador ou Consulta.
  4. Entregue a senha temporária por um meio reservado. Ela aparece somente na emissão ou redefinição.
  5. Para retirar um acesso, desative a conta; para recuperar acesso, use a redefinição de senha disponível.
  6. Use Minha senha para alterar a sua credencial e Sair para encerrar a sessão.

Resultado esperado

A central registra ações por conta individual e aplica o perfil correspondente.

Observações importantes

  • Este acesso pertence ao operador da gerência. Ser administrador de uma instalação de cliente não cria automaticamente uma conta nesta central.
  • Consulta permite leitura; alterações administrativas exigem Administrador. O último administrador ativo é protegido contra remoção indevida.
  • Edição, redefinição e troca de senha revogam sessões conforme a operação. A sessão também expira; entre novamente quando solicitado.
  • Chaves técnicas, senhas e comandos com credenciais não devem ser publicados na Wiki ou enviados em capturas de diagnóstico.

Se precisar de ajuda

  • Acesso apenas de leitura: confirme seu perfil com o administrador da central.
  • Senha temporária recusada: solicite nova emissão; não compartilhe a conta de outro administrador.
Integrações e backups

Gerenciar planos, renovações e recursos por cliente

Confira a instalação correta antes de alterar sua licença ou disponibilizar um módulo contratado.

Onde encontrarCentral de gerência → Planos / Renovações / Integrações

Antes de começar

  • Use uma conta Administrador da central e tenha a alteração comercial autorizada.

Passo a passo

  1. Em Visão geral, identifique a instalação pelo domínio e pela empresa, sem usar apenas o nome do plano.
  2. Em Planos, confira nome, valores, limites registrados, suporte e recursos incluídos.
  3. Em Renovações, selecione a instalação e registre a nova validade e o período de tolerância conforme o contrato.
  4. Em Integrações, selecione o cliente e revise os recursos individuais, inclusive os módulos principais de que dependem.
  5. Salve as permissões e aguarde a sincronização da instalação. Confira o resultado no painel do cliente autorizado.
  6. Se uma opção continuar ausente, confira também a versão do pacote e as permissões da conta do cliente.

Resultado esperado

Plano, validade e concessões ficam associados à instalação selecionada.

Observações importantes

  • Renovação registrada na gerência não é processamento de uma cobrança financeira.
  • Desligar o módulo principal bloqueia seus recursos dependentes, mesmo que uma opção individual permaneça marcada.
  • Capacidade, presença, ações rápidas, agendamento de conversas e central de ajuda pública exigem concessões próprias.
  • Limites cadastrados no plano não devem ser anunciados como bloqueios técnicos universais de criação de usuários ou canais.
  • Uma alteração de recurso não apaga automaticamente o histórico nem configura credenciais do provedor.

Se precisar de ajuda

  • Recurso não liberado: confira cliente selecionado, dependência do módulo principal e sincronização.
  • Não altere um plano compartilhado para resolver uma exceção de um único cliente sem revisar o impacto nos demais.
Integrações e backups

Preparar uma nova instalação pela gerência

Gere o convite para um servidor novo e acompanhe o resultado sem confundir bootstrap com atualização.

Onde encontrarCentral de gerência → Visão geral → Instalações → Nova instalação

Antes de começar

  • Use uma conta Administrador da gerência e um servidor novo autorizado para essa instalação.

Passo a passo

  1. Confirme com o responsável técnico que o destino é uma VM nova compatível, com domínio próprio e os pré-requisitos apresentados pelo assistente.
  2. Selecione Ubuntu Server 24.04 LTS ou Debian 13 e preencha empresa, domínio, identificador, prefixo de protocolos e administrador.
  3. Escolha plano, validade da licença, canal e versão a instalar. Confira se a origem da versão é publicada ou preparada.
  4. Gere o comando e guarde a chave temporária por um meio protegido. A senha do administrador será definida no terminal do servidor novo.
  5. Entregue comando e chave somente ao responsável autorizado para executar a instalação naquele servidor.
  6. Acompanhe Instalações em preparação. Em falha, preserve os arquivos e encaminhe a etapa ao suporte para retomar no mesmo ambiente.
  7. Após concluir, confira HTTPS, login inicial, licença, empresa, recursos contratados e backups antes de conectar canais reais.

Resultado esperado

A instalação nova fica identificada e pode sincronizar licença e atualizações conforme seu papel.

Observações importantes

  • O assistente atual requer VM amd64, pelo menos 4 GB de RAM e 15 GB livres, com domínio e acesso HTTPS preparados. Esses mínimos não garantem capacidade para qualquer volume de atendimento.
  • O instalador rejeita CT/LXC. O sistema escolhido deve corresponder ao servidor; não altere proteções do host para contornar a verificação.
  • Uma instalação existente não deve receber novo bootstrap. Atualização e adoção de uma instalação existente seguem procedimentos próprios.
  • Escolher uma versão preparada para um servidor novo não publica essa versão para os demais clientes.
  • Chave temporária expirada pode exigir reemissão pela gerência. Não crie outra instalação nem apague volumes para repetir uma tentativa sem revisar o estado.
  • Cada instalação mantém banco, configurações, canais e segredos próprios. Nenhuma base operacional de outro cliente é fornecida pelo assistente.

Se precisar de ajuda

  • Pré-requisito recusado: confira sistema, arquitetura e tipo da virtualização com o responsável técnico.
  • Instalação interrompida: preserve a referência e a etapa; o suporte deve conferir o estado antes da retomada.
Integrações e backups

Conferir e publicar uma versão comercial preparada

Revise o pacote cumulativo e suas validações antes de disponibilizá-lo no catálogo.

Onde encontrarCentral de gerência → Atualizações → versões preparadas

Antes de começar

  • Use uma conta Administrador da gerência e tenha a publicação explicitamente autorizada.

Passo a passo

  1. Confira a versão preparada, o canal e a data; abra Ver alterações para ler as notas específicas daquela versão.
  2. Solicite à equipe técnica as evidências de base cumulativa, compatibilidade, imagens e acesso dos clientes aos pacotes.
  3. Diferencie a validação funcional na matriz do ensaio do atualizador em consumidor isolado. Confirme quais transições foram efetivamente testadas.
  4. Quando houver autorização para disponibilizar a versão, clique em Publicar atualização e aguarde a confirmação da gerência.
  5. Se a gerência recusar a validação de pacotes, preserve o rascunho e encaminhe a mensagem ao suporte; não troque a referência por uma imagem sem validação.
  6. Confira a versão publicada no catálogo. A instalação em um cliente continua dependendo da solicitação de seu administrador.

Resultado esperado

A versão autorizada passa ao catálogo sem iniciar automaticamente instalações.

Observações importantes

  • Pronta para publicar identifica um rascunho; não comprova publicação nem instalação nos clientes.
  • A gerência verifica manifests e blobs das imagens ao preparar e ao publicar. Não contorne uma recusa de autenticação, digest ou disponibilidade.
  • Pacotes comerciais são cumulativos e preservam as diferenças de marca, licença e configuração de cada instalação.
  • A antiga ação de enviar rascunho à homologação foi desativada: a matriz recebe implantação direta da equipe técnica.
  • O catálogo normal do consumidor não oferece rascunhos privados. Uma validação de download por HTTPS não deve ser registrada como ensaio integral de atualização.

Se precisar de ajuda

  • Pacote não aparece no cliente: confira publicação, canal, licença, versão mínima e resultado da consulta.
  • Publicado por engano: não reinstale nem altere a sequência para disfarçar o estado; solicite análise do operador.
Integrações e backups

Gerar a chave FSNET IA de uma empresa

Emita ou substitua uma chave exclusiva da instalação e entregue os dados à integração correta.

Onde encontrarCentral de gerência → Visão geral → Instalações cadastradas → Abrir cadastro

Antes de começar

  • Tenha autorização para administrar a chave daquela empresa e acesso Administrador à gerência.

Passo a passo

  1. Entre na gerência com uma conta Administrador. Em Visão geral, localize a empresa e confira seu domínio e plano.
  2. Clique em Abrir cadastro e localize Chave de acesso · FSNET IA. Confira a empresa no título do cadastro e a franquia apresentada.
  3. Se a geração estiver bloqueada, confira no plano e nos recursos da instalação as concessões Inteligência artificial e FSNET IA, a franquia mensal positiva e a validade da licença.
  4. Para a primeira emissão autorizada, clique em Gerar chave da empresa. Aguarde a confirmação sem repetir o clique.
  5. Use Copiar chave e guarde-a de forma protegida antes de fechar. Copie também a URL da integração exibida nesse cadastro.
  6. Na instalação correspondente, o administrador autorizado cadastra essa chave e a URL fornecida no cartão FSNET IA em Configurações → Integrações → Inteligência artificial. Salve e confira o resultado do teste permitido pela operação.
  7. Se já existe uma chave e a substituição foi autorizada, marque Substituir a chave atual e use Substituir chave da empresa. Atualize as integrações que usavam a chave anterior.
  8. Para retirar o acesso sem emitir outra chave, abra a seção FSNET IA da gerência, selecione a mesma empresa e use Revogar chave.

Resultado esperado

Uma chave individual fica vinculada à instalação selecionada, sem compartilhar a credencial principal do servidor de IA.

Observações importantes

  • O recurso está implementado no cadastro da empresa e na seção FSNET IA da gerência. A chave completa aparece somente na emissão; depois são consultados prefixo, data e estado.
  • Há somente uma chave ativa por instalação. Gerar uma substituta revoga a anterior imediatamente; a integração do cliente não recebe a nova chave automaticamente.
  • Esta é uma chave FSNET IA, não uma chave OpenAI nem a chave de ativação da instalação. Ela também não substitui a credencial interna que conecta a gerência ao servidor de IA.
  • A chave e a URL da gerência atendem ao gateway de texto sem streaming. Não habilitam, por si só, transcrição de áudio ou análise de imagens.
  • Se a instalação já usa a chave e a URL do cartão FSNET IA para áudio ou imagens, combine a configuração com o suporte antes de substituí-las: esses usos compartilham os campos no cartão, mas o gateway comercial de texto não fornece os endpoints de mídia.
  • Gerar a chave não comprova que a conexão da central com o servidor de IA está configurada. Confira o aviso de conexão no cadastro.
  • Não envie a chave em capturas, chamados públicos ou mensagens de atendimento. Guarde-a somente no local autorizado e na configuração da empresa correta.

Se precisar de ajuda

  • Botão bloqueado: confira os dois recursos da licença, a franquia positiva e, em substituição, a confirmação exigida no cadastro.
  • Licença vencida ou fora da tolerância: regularize-a na gerência antes de usar a FSNET IA.
  • Chave perdida após fechar: ela não pode ser consultada integralmente de novo. Planeje uma substituição e a atualização das integrações afetadas.
  • Erro após solicitar emissão: confira estado e prefixo da chave antes de repetir; uma nova emissão pode invalidar a anterior.
Integrações e backups

Conferir franquia e consumo da FSNET IA

Separe tokens consumidos, reservas e saldo antes de tratar uma falta de franquia.

Onde encontrarCentral de gerência → FSNET IA → Cliente

Antes de começar

  • Use uma conta autorizada da gerência; a reconciliação exige Administrador e evidência do consumo real.

Passo a passo

  1. Selecione a instalação correta em Cliente e confira Mês, Franquia, Consumidos, Reservados e Disponíveis.
  2. Confira o estado da conexão da central e a lista de chaves. Prefixo e datas identificam a chave sem exibir seu conteúdo completo.
  3. Se houver reservas, consulte a identificação, o mês e a situação das solicitações pendentes.
  4. Para uma solicitação cujo resultado ficou incerto, peça ao operador a conferência do consumo efetivo no provedor. Não considere uma falha de resposta como prova de consumo zero.
  5. Somente após essa conferência, e quando a solicitação estiver pendente há pelo menos cinco minutos, use Conferir consumo pendente.
  6. Informe a identificação da solicitação, os tokens confirmados e uma referência da conferência. Revise os dados antes de Registrar consumo confirmado.
  7. Atualize a visualização para conferir consumo, reservas e saldo resultantes.

Resultado esperado

A franquia fica acompanhada por instalação, com registro do consumo confirmado e das pendências reconciliadas.

Observações importantes

  • A franquia é mensal, calculada no horário de Recife. A virada do mês inicia a apuração daquele mês; não é uma cobrança financeira automática.
  • Antes da chamada, o gateway reserva orçamento. Somente o uso informado pelo provedor é registrado como consumo concluído.
  • Timeout, erro ou ausência de medição podem manter a reserva. Não há estorno automático de uma chamada que possa ter sido processada.
  • Saldo disponível considera consumo e reservas. Uma solicitação pode ser recusada por falta de franquia ou por orçamento reservado em chamadas ainda não conferidas.
  • Essa franquia cobre texto sem streaming. Áudio e imagens têm configuração e medição próprias e não devem ser contabilizados como incluídos nessa cota.
  • O acompanhamento da gerência não guarda o conteúdo das conversas de IA. A referência de conferência não deve conter senha, chave ou mensagem de cliente.

Se precisar de ajuda

  • Sem franquia: confira plano e concessões da instalação antes de gerar outra chave.
  • Conexão da central pendente: solicite configuração ao operador; trocar a chave do cliente não configura o serviço interno.
  • Conferência recusada: confirme a instalação, a solicitação, o estado pendente e o prazo mínimo. Não invente um valor para liberar a reserva.
Privacidade

Registrar uma solicitação de privacidade

Organize pedidos de acesso, correção, exclusão, oposição ou portabilidade no painel.

Onde encontrarAdministração → LGPD → Solicitações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Clique em Novo registro e escolha o direito solicitado.
  2. Preencha título, responsável, prazo e situação.
  3. Busque o contato por nome ou identificador e vincule o cadastro correto.
  4. Registre finalidade, informações de análise e evidências necessárias, sem inserir segredos.
  5. Marque identidade verificada somente após o procedimento de confirmação definido pela empresa.
  6. Salve e acompanhe o protocolo.
  7. Use Revisar para atualizar andamento e conclusão.

Resultado esperado

A solicitação fica registrada com responsável e prazo de acompanhamento.

Observações importantes

  • O sistema registra o tratamento; marcar uma solicitação como concluída não apaga automaticamente dados.
  • A análise do pedido e das obrigações da empresa deve ser conduzida pelo responsável de privacidade.
  • Pedidos recebidos por e-mail também podem ser cadastrados.

Se precisar de ajuda

  • Contato não encontrado: use no mínimo três caracteres e confira o cadastro.
  • Registro sem prazo/responsável: complete a informação para permitir acompanhamento.
Privacidade

Conferir alcance e exportar o histórico de um titular

Prepare uma exportação para revisão e entrega pelo processo de privacidade da empresa.

Onde encontrarAdministração → LGPD → Solicitações → Ver alcance / Exportar histórico

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Abra uma solicitação vinculada ao contato correto.
  2. Confira o tipo de direito, a identidade verificada e a autorização do responsável.
  3. Clique em Ver alcance para consultar os atendimentos e mensagens abrangidos.
  4. Em solicitações de acesso ou portabilidade elegíveis, use Exportar histórico.
  5. Revise o arquivo JSON gerado e confira se corresponde à pessoa e ao escopo solicitado.
  6. Entregue pelo meio seguro definido pela empresa e registre a evidência de tratamento.

Resultado esperado

O arquivo contém o histórico abrangido pelo exportador do Omnichannel.

Observações importantes

  • Anexos e dados de outros sistemas exigem tratamento separado.
  • A exportação contém dados pessoais e não deve ser enviada para um contato sem confirmação.
  • Ver alcance não executa exclusão.

Se precisar de ajuda

  • Exportação recusada: confira tipo de pedido, vínculo e verificação de identidade.
  • Alcance inesperado: revise o contato antes de prosseguir.
Privacidade

Registrar retenção de dados e simular alcance

Documente prazos e confira quantos registros seriam abrangidos pela regra.

Onde encontrarAdministração → LGPD → Retenção

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Crie uma política de retenção com título e categoria.
  2. Preencha prazo em dias, finalidade, responsável e fundamentação definida pela empresa.
  3. Salve como rascunho ou revisado conforme a análise realizada.
  4. Use Simular para consultar os candidatos por idade.
  5. Leia o resultado e registre a decisão do responsável.
  6. Solicite procedimento específico quando houver uma decisão de exclusão a executar.

Resultado esperado

A regra e sua revisão ficam documentadas, com uma simulação do alcance.

Observações importantes

  • A simulação não apaga dados nem aplica automaticamente a política.
  • Retenção de dados pessoais nesta tela é diferente da retenção de cópias na área Backups.

Se precisar de ajuda

  • Resultado inesperado: confira categoria e prazo.
  • Não marque a exclusão como realizada apenas porque uma simulação foi executada.
Privacidade

Revisar fornecedores e compartilhamentos

Organize os registros de fornecedores e mantenha evidências de revisão.

Onde encontrarAdministração → LGPD → Fornecedores

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Crie um registro com título e responsável.
  2. Informe destinatário, país, mecanismo e referência contratual nos campos correspondentes.
  3. Registre finalidade, avaliação e evidências.
  4. Mantenha como rascunho até a revisão.
  5. Atualize para Revisado quando o responsável concluir a análise e salve.

Resultado esperado

O registro fica disponível para acompanhamento e revisão.

Observações importantes

  • O painel organiza evidências; seus indicadores não certificam conformidade.
  • Responsáveis e procedimentos de privacidade devem ser definidos pela empresa.

Se precisar de ajuda

  • Conflito de revisão: atualize o registro antes de reaplicar sua alteração.
  • Evidência ausente deve ser tratada como pendência.
Privacidade

Registrar e acompanhar um incidente

Organize os registros de incidentes e mantenha evidências de revisão.

Onde encontrarAdministração → LGPD → Incidentes

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Crie o registro com título objetivo e responsável.
  2. Informe prazo, situação e evidências disponíveis.
  3. Registre a avaliação e as medidas tomadas sem incluir credenciais nos campos.
  4. Atualize para Em tratamento enquanto houver ações pendentes.
  5. Encerre somente após registrar a conclusão e o encaminhamento do responsável.

Resultado esperado

O registro fica disponível para acompanhamento e revisão.

Observações importantes

  • O painel organiza evidências; seus indicadores não certificam conformidade.
  • Responsáveis e procedimentos de privacidade devem ser definidos pela empresa.

Se precisar de ajuda

  • Conflito de revisão: atualize o registro antes de reaplicar sua alteração.
  • Evidência ausente deve ser tratada como pendência.
Privacidade

Manter o inventário de dados

Organize os registros de inventário de dados e mantenha evidências de revisão.

Onde encontrarAdministração → LGPD → Inventário de dados

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Crie um registro por atividade/categoria relevante para a empresa.
  2. Informe finalidade, dados necessários, responsável e fundamento definido no processo de privacidade.
  3. Registre destinatários, retenção e evidências nos campos aplicáveis.
  4. Revise a informação com as áreas envolvidas.
  5. Salve como Revisado apenas após conferir o conteúdo e atualize quando a operação mudar.

Resultado esperado

O registro fica disponível para acompanhamento e revisão.

Observações importantes

  • O painel organiza evidências; seus indicadores não certificam conformidade.
  • Responsáveis e procedimentos de privacidade devem ser definidos pela empresa.

Se precisar de ajuda

  • Conflito de revisão: atualize o registro antes de reaplicar sua alteração.
  • Evidência ausente deve ser tratada como pendência.
Privacidade

Conferir indicadores de privacidade e segurança

Veja pendências de revisão, segundo fator, backups e solicitações.

Onde encontrarAdministração → LGPD → indicadores

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Clique em Atualizar indicadores.
  2. Confira a proporção de administradores e equipe com dois fatores.
  3. Verifique solicitações vencidas e sem prazo.
  4. Revise categorias de retenção, fornecedores e incidentes em tratamento.
  5. Consulte a última rotina de backup e o último ensaio de restauração registrados.
  6. Encaminhe cada pendência ao responsável pela respectiva área.

Resultado esperado

Você identifica o que exige acompanhamento no processo de privacidade.

Observações importantes

  • Indicadores não certificam conformidade.
  • Ausência de registros não comprova ausência de risco ou atividade.
  • Ensaio de banco não comprova recuperação de mídias externas.

Se precisar de ajuda

  • Indicador não medido: solicite o registro da evidência correspondente.
  • Valor divergente: confira a data de medição e atualize.
Privacidade

Entender a segurança das sessões do chat do site

Saiba o que acontece ao renovar uma sessão de visitante ou abrir anexos do webchat.

Onde encontrarChat do site; Configurações → Integrações → Chat do site

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Use o widget e a configuração fornecidos para a sua instalação, sempre em página HTTPS.
  2. Se uma sessão antiga deixar de autenticar após atualização de segurança, recarregue o widget para obter uma sessão válida.
  3. Ao retomar uma conversa, deixe o widget usar sua credencial própria. Um identificador público da conversa não comprova o direito de acessá-la.
  4. Abra anexos pelos controles do chat; não copie URLs que contenham credenciais nem publique dados de sessão em chamados.
  5. Se a sessão não retomar, encaminhe horário, versão e referência do erro ao suporte. O histórico visível aos atendentes pode permanecer mesmo que o visitante receba uma nova sessão.

Resultado esperado

Sessões e anexos do visitante seguem autenticação e limites de acesso próprios.

Observações importantes

  • A correção comercial 1.0.37-pilot passou a usar credencial secreta de retomada, expiração e revogação; sessões legadas não são aceitas como prova de acesso.
  • Anexos de notas internas não são disponibilizados ao visitante do chat.
  • As correções de segurança também reforçaram a troca de senha e impediram que testes de conectores encaminhassem credenciais por redirecionamentos.
  • Uma atualização de dependências e testes aprovados não constituem garantia de ausência de todas as vulnerabilidades.

Se precisar de ajuda

  • Anexo negado: confirme se pertence ao visitante e se a sessão continua válida.
  • Não envie tokens, senhas ou conteúdo de outro cliente para diagnosticar uma sessão.
Ajuda e aplicativo

Usar o Omnichannel no celular

Acesse o painel responsivo ou o app Android oficial e confira o painel e a conta corretos.

Onde encontrarNavegador do celular; aplicativo Omnichannel quando fornecido

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. No navegador do celular, abra o endereço HTTPS fornecido pela sua empresa.
  2. Para Android, abra o aplicativo oficial no Google Play pelo link abaixo e confira o publicador FSNET PROVEDOR DE INTERNET LTDA: https://play.google.com/store/apps/details?id=com.fsnet.omnichannel .
  3. No aplicativo, abra Seu painel e confira o domínio HTTPS e o identificador da empresa, nas opções avançadas quando necessário.
  4. Entre com e-mail, senha e segundo fator quando solicitado. Uma demonstração deve ser selecionada explicitamente; ela não substitui uma conexão real com erro.
  5. Abra Meus atendimentos, departamentos permitidos, agentes virtuais ou encerrados conforme sua conta.
  6. Consulte Conta para segurança, notificações e versão/build. Use Ações do atendimento para ferramentas adicionais na conversa.

Resultado esperado

Você acessa os atendimentos permitidos no dispositivo móvel.

Observações importantes

  • Em 07/10/2026, a página pública do Google Play oferece o aplicativo Android na versão 0.5.4, atualizada em 28/09/2026. A disponibilidade para instalar depende também da conta, região e compatibilidade do aparelho.
  • O build Android 11 corresponde à versão 0.5.4. A instalação pelo Google Play deve ser atualizada pela própria loja; o APK avulso assinado com outra chave não substitui essa instalação.
  • A distribuição iOS/App Store não foi confirmada. Código iOS e builds de simulador não equivalem a publicação para iPhone.
  • O painel web responsivo e o app nativo são produtos de interface distintos e podem oferecer percursos diferentes.
  • O app permite selecionar um painel HTTPS, mas sua marca e a configuração de push distribuídas são FSNET. Isso não comprova distribuição de uma versão personalizada para outra empresa.

Se precisar de ajuda

  • Domínio recusado: informe somente o domínio HTTPS ou /api/v1 aceito pelo app, sem páginas internas ou parâmetros.
  • Recurso ausente no app: use o painel web e confira a versão instalada.
Ajuda e aplicativo

Atender e executar ações no aplicativo

Use os recursos de atendimento incorporados ao app 0.5.4 conforme licença e permissões.

Onde encontrarAplicativo → conversa / menu lateral

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Escolha a lista e o filtro de responsável ou departamento; use busca e carregamento adicional para localizar o atendimento.
  2. Abra a conversa, confira responsável e status e assuma quando permitido. Histórico somente leitura não permite responder ou criar nota.
  3. Use resposta ao cliente ou nota interna, conferindo o modo. Reações aparecem na mensagem original.
  4. Nos atalhos de mídia, escolha arquivo, fotos/vídeos, câmera, gravação de áudio ou figurinhas; confira a prévia e confirme o envio.
  5. Use o player na mensagem para ouvir áudio. Abra imagem, vídeo ou documento nos controles disponíveis.
  6. Abra Ações do atendimento para equipe, transferência, etiquetas, histórico e agendamento, conforme licença e permissões.
  7. Para atendimento WhatsApp encerrado, use a abertura de novo chamado e modelos aprovados, em vez de presumir reabertura direta.
  8. Em consultas e ações do ERP, confira o cliente e confirme cada operação. Em resultado incerto, consulte o histórico antes de repetir.

Resultado esperado

As funções disponíveis usam as permissões e validações da mesma API do painel.

Observações importantes

  • Datas completas e separadores por dia ajudam a distinguir mensagens antigas. Data ausente ou inválida aparece como não informada.
  • A contagem e a marca de leitura seguem o responsável e o estado da conversa; abrir uma tela de revisão não equivale a assumir o atendimento.
  • O formulário nativo de HSM contempla variáveis de texto. A presença de um modelo com mídia ou botão não comprova que todos os seus parâmetros possam ser preenchidos nesse formulário.
  • As funções dependem do pacote instalado, da API, da licença e do perfil. O app não consulta diretamente o ERP ou a Meta com credenciais de servidor.
  • Uma confirmação incerta bloqueia reenvio automático. Confira o histórico e a mensagem de erro antes de liberar outra tentativa.

Se precisar de ajuda

  • Mídia interrompida no Android: escolha novamente o arquivo e confira o atendimento.
  • Resposta incerta: consulte o histórico antes de repetir.
  • Permissão de câmera/microfone recusada: revise as configurações do aparelho.
Ajuda e aplicativo

Conferir limitações e notificações do aplicativo

Identifique o que depende do painel web, da distribuição ou de serviços externos.

Onde encontrarAplicativo → Conta → Sobre / Notificações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira a versão e o build em Conta → Sobre.
  2. Use o painel web para o designer completo de fluxos, conexões OAuth e tarefas avançadas sem formulário nativo no app.
  3. Confira licença, permissão e conexão antes de usar funções administrativas ou telefonia.
  4. Para alertas com o app fechado, confira Conta → Notificações, o registro do dispositivo e as permissões do Android.
  5. Se uma mídia não tocar no aparelho, informe versão do Android, modelo, formato e erro ao suporte, sem reenviar dados de clientes como teste.
  6. Atualize pelo canal em que recebeu o aplicativo. Versão de simulador, APK avulso e instalação do Google Play têm requisitos diferentes.

Resultado esperado

Você sabe quais tarefas pode concluir naquele build e quais exigem outro acesso.

Observações importantes

  • Push Android está configurado na distribuição FSNET; outros painéis e iOS exigem configuração própria. Consulta em primeiro plano e push remoto não são a mesma entrega.
  • Telefonia nativa não inclui softphone: comandos dependem de central e conector homologados, permissões e capacidades retornadas pelo servidor.
  • Os testes de navegador e widget não comprovam câmera, microfone, teclado e todos os codecs em cada modelo de aparelho.
  • O editor móvel de fluxos trata metadados e preserva blocos existentes; não substitui o designer visual completo.
  • Instalação e publicação de pacotes comerciais de servidor continuam na gerência/painel, sem execução pelo aplicativo.

Se precisar de ajuda

  • Aviso não chegou com o app fechado: confira se o serviço de push foi efetivamente implantado.
  • Falta de botão pode refletir build antigo ou permissão restrita.
Ajuda e aplicativo

Resolver mensagens que não chegam ou não saem

Confira canal, status e janela de atendimento antes de refazer envios.

Onde encontrarIntegrações → canal → status / Registros

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira se o problema afeta um contato ou todo o canal.
  2. Consulte a situação da mensagem: enfileirada, enviada, entregue, lida ou falha.
  3. No WhatsApp, confira o aviso de janela e a necessidade de HSM.
  4. Peça ao administrador para verificar canal ativo, licença, autorização e webhook.
  5. Consulte os registros e a mensagem de erro do horário correspondente.
  6. Após corrigir, faça um teste com contato autorizado da própria equipe.
  7. Confira o resultado final e evite duplicar mensagens que já constam como enviadas.

Resultado esperado

O diagnóstico identifica a etapa com problema e orienta a correção.

Observações importantes

  • Enfileirada não significa entregue.
  • Entrega e leitura dependem das confirmações do canal.
  • Não desconecte um canal saudável apenas para tentar limpar um erro isolado.

Se precisar de ajuda

  • Informe ao suporte protocolo, canal, horário, ação e erro visível.
  • Não envie senha, token ou exportação completa de clientes no chamado.
Ajuda e aplicativo

Resolver falhas de integração e configuração

Organize a conferência de credenciais, endereço, licença e resultado do teste.

Onde encontrarAdministração → Integrações → cartão do serviço

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confirme qual serviço falhou e o horário.
  2. Confira se o módulo está liberado pela licença e se sua conta pode administrá-lo.
  3. Revise URL, modalidade de autenticação e campos obrigatórios, sem substituir a credencial desnecessariamente.
  4. Salve antes de executar o teste quando a tela exigir.
  5. Abra Erros das integrações ou Registros de erros, filtre serviço e período e consulte a referência de diagnóstico.
  6. Encaminhe o erro ao responsável pelo serviço ou ao suporte com contexto suficiente.

Resultado esperado

A falha é isolada entre configuração local, autorização, licença e serviço externo.

Observações importantes

  • Credenciais mascaradas ou não retornadas ao navegador são comportamento esperado.
  • Teste de conexão bem-sucedido não garante que toda operação externa esteja autorizada.

Se precisar de ajuda

  • Erro de autenticação: confirme validade e permissões.
  • Timeout: confira conectividade e disponibilidade.
  • Bloqueio por licença: confira o contrato antes de alterar endpoints.
Ajuda e aplicativo

Preparar um chamado de suporte útil

Reúna os dados necessários para investigar sem expor informações desnecessárias.

Onde encontrarCanal de suporte definido no contrato da sua empresa

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Informe o domínio do seu painel e a versão visível.
  2. Descreva o que tentou fazer e qual resultado esperava.
  3. Informe data, horário, canal e protocolo afetado.
  4. Copie a mensagem de erro e descreva se acontece com outros usuários.
  5. Inclua uma captura somente se necessária, ocultando dados pessoais que não ajudam no diagnóstico.
  6. Informe quais verificações já foram feitas e aguarde a orientação para a próxima ação.

Resultado esperado

O suporte recebe contexto suficiente para reproduzir ou localizar o problema.

Observações importantes

  • Não envie tokens, senhas, códigos de recuperação ou ambientes completos.
  • O endereço de suporte deve ser o fornecido no contrato; esta wiki não inventa um destinatário.
  • A wiki não cria chamados automaticamente.

Se precisar de ajuda

  • Se a dúvida for sobre ausência de menu, informe também seu perfil e o módulo esperado.
Ajuda e aplicativo

Pedir ajuda e acompanhar uma solicitação

Um roteiro para quem conversa com a empresa pelos canais de atendimento.

Onde encontrarCanal oficial da empresa: WhatsApp, redes sociais, Telegram ou chat

Antes de começar

  • Use um canal oficial divulgado pela sua empresa.

Passo a passo

  1. Abra o canal oficial e explique o que precisa com suas palavras.
  2. Se for solicitado, confirme os dados necessários para identificar o titular e o serviço.
  3. Responda às perguntas de contexto sem repetir informações já enviadas, quando possível.
  4. Para suporte, descreva o problema e informe o contrato ou local do serviço quando houver mais de um.
  5. Para financeiro, diga se precisa de boleto, Pix ou nota fiscal e confira os dados recebidos.
  6. Se precisar de uma pessoa, solicite atendimento humano e acompanhe a orientação de fila/horário.
  7. Ao final, confirme se a dúvida foi resolvida e responda à pesquisa ou escolha pular.

Resultado esperado

A solicitação é compreendida e encaminhada pelo fluxo configurado pela empresa.

Observações importantes

  • As perguntas e as ações disponíveis variam com o canal, a integração e o fluxo instalado.
  • Nunca forneça senha bancária, senha pessoal de e-mail ou códigos de autenticação.
  • Comprovante pode exigir conferência humana antes de qualquer conclusão financeira.

Se precisar de ajuda

  • Fora do horário: leia a mensagem de disponibilidade e mantenha o protocolo.
  • Resposta inadequada: reformule a solicitação ou peça transferência para a equipe.
Ajuda e aplicativo

Entender os termos usados no Omnichannel

Uma referência rápida para os nomes mais frequentes nas telas.

Onde encontrarTodas as áreas do painel

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Campos e opções

CampoComo preencher
ContatoPessoa ou identidade recebida por um canal.
Atendimento / protocoloRegistro de uma solicitação e sua conversa.
CanalOrigem e transporte das mensagens, como WhatsApp ou webchat.
Departamento / setorEquipe ou fila responsável pela solicitação.
SLAPrazo operacional de primeira resposta ou resolução.
HSM / templateModelo de mensagem aprovado para envio pelo WhatsApp.
Opt-in / opt-outAutorização ou recusa/descadastro para uma comunicação.
FluxoSequência de blocos que define o caminho automático.
Rascunho / publicadoEdição preparada versus versão disponibilizada à operação.
Agente virtualAutomação com função, conhecimento e ferramentas autorizadas.
IntençãoClassificação do pedido do cliente.
WebhookEndereço usado por um serviço para entregar eventos a outro.
ERP / IXC / SGPSistema integrado que fornece dados e operações do assinante.
Readiness / prontidãoVerificação técnica de disponibilidade do serviço.
RetençãoRegra de manutenção de dados ou cópias, conforme o contexto.

Passo a passo

  1. Identifique o termo na tela e consulte a tabela.
  2. Confira também o artigo da tarefa antes de realizar uma ação.
  3. Em caso de diferença entre versões, use a mensagem atual do painel como referência.

Resultado esperado

Você distingue os conceitos de operação, canal, automação e integração.

Observações importantes

  • O mesmo contato pode ter vários protocolos.
  • Enviado, entregue e lido são estados diferentes.

Se precisar de ajuda

  • Um nome técnico sem explicação pode ser enviado ao administrador junto com a tela em que aparece.
Ajuda e aplicativo

Consultar cobertura e disponibilidade da wiki

Entenda o alcance do manual cumulativo e as diferenças entre versão, licença, homologação e instalação.

Onde encontrarWiki → categorias, busca e manual completo

Antes de começar

  • A Wiki é uma documentação pública do produto. Não é necessário acesso ao painel para ler.
  • Tenha a versão do seu painel quando precisar comparar uma função.

Passo a passo

  1. Escolha uma categoria ou pesquise a tarefa. Use o filtro de perfil para encontrar instruções relevantes.
  2. Confira o caminho, os pré-requisitos, o resultado esperado e as limitações do artigo.
  3. Compare o recurso com a versão instalada e com os módulos e permissões da sua empresa.
  4. Consulte Novidades para distinguir as funções em homologação das versões publicadas.
  5. Use Manual completo para leitura ou impressão de todos os guias. As referências externas complementam os procedimentos do produto.
  6. Se encontrar diferença, envie ao suporte o título do guia, a versão e a descrição da tela.

Resultado esperado

Você utiliza o manual conforme a versão e as capacidades efetivamente disponíveis na sua instalação.

Observações importantes

  • Edição 1.5.0 revisada em 14/10/2026 a partir do código cumulativo, do histórico de mudanças, dos registros de implantação e de referências oficiais consultadas. Não foi feita auditoria autenticada de cada instalação de cliente nesta entrega.
  • A cobertura preserva os guias de atendimento, canais, IA, automação, clientes e IXC, equipe, indicadores, campanhas, integrações, privacidade e aplicativo, além dos 30 tipos de bloco documentados no construtor.
  • Os recursos mais recentes correspondem à matriz 1.0.67-pilot. Sua inclusão neste manual não significa publicação nem instalação em todos os clientes.
  • A gerência central é operada pelo fornecedor. Seus procedimentos não concedem ao administrador de um cliente acesso a outras empresas.
  • Modelos reconhecidos, campos de configuração e APIs disponíveis não provam que um conector externo esteja homologado ou que uma operação tenha sido executada.
  • Documentação de segurança e privacidade explica controles do sistema; sua configuração e o cumprimento das obrigações da empresa dependem da operação responsável.
  • Os exemplos usam dados fictícios. Não inclua senhas, tokens, chaves de recuperação ou dados desnecessários de clientes em capturas enviadas ao suporte.

Se precisar de ajuda

  • Informe ao suporte o título do artigo e a divergência encontrada. Alterações das APIs externas e novas versões podem exigir revisão das instruções.
Ajuda e aplicativo

Novidades do Omnichannel e disponibilidade por versão

Acessos externos das plataformas, integrações revisadas e mudanças recentes de IA, Pix e atendimento. Confira a versão instalada antes de aplicar cada procedimento.

Onde encontrarWiki → Novidades; painel → Atualizações / Sobre

Antes de começar

  • Tenha a versão indicada no seu painel para comparar os recursos.
  • A leitura desta página não instala atualizações nem altera configurações.

Novidades por área e versão

Área / versãoO que mudou
Wiki 1.5.0 · IntegraçõesDiretório de links externos e atalhos no início dos guias: Meta, WhatsApp Manager, OpenAI, Gemini, Claude, Telegram, IXC, SGP, Google Drive e e-mail.
IA · 1.0.67Mary apresenta o nome da empresa da instalação na primeira resposta, com saudação por horário e sem repetir a apresentação.
WhatsApp · 1.0.66Conteúdo indisponível recebe aviso claro para o atendente, sem disparar resposta automática da IA.
Comprovante Pix · 1.0.65Consulta de baixa no IXC e segunda conferência após dois minutos quando necessário; confirmação ou encaminhamento sem avisos intermediários.
Cobranças IXC · 1.0.64Verificação do telefone atual e cancelamento de cobranças pendentes quando o destinatário antigo foi removido do cadastro.
Faturas · 1.0.63Faturas abertas que ainda não venceram não são contadas como atrasadas na resposta automática.
Atendimento e notificaçõesCartões compactos, destaque de mensagens pendentes, leitura pelo responsável, som e contador da aba por atendente; atendimento no celular com mais área de conversa.
Histórico e satisfaçãoDatas por dia, cobranças repetidas agrupadas com acesso aos envios originais, reações na mensagem e reconhecimento de avaliações tardias.
Identificação e IXCNome, endereço e telefones na consulta; documentos com espaços; confirmação de cadastro; Pix com vencimento e valor; desbloqueio conferido no ERP.
Cobranças IXCRelatório com filtros e motivos de bloqueio; proteção contra cobrança paga, cancelada ou ambígua; modelos com PDF e Pix da fatura.
WhatsApp · 1.0.53–1.0.60Cartões independentes por número, login Meta para números adicionais e configuração manual de API existente com validação antes da ativação.
Instagram · 1.0.56Tratamento específico de menções em stories, preservando respostas a stories e conversas em andamento.
Inteligência artificialProvedores sujeitos à licença; texto, imagem e transcrição configurados separadamente; confirmação antes de ações e encaminhamento humano quando necessário.
Fluxos e pesquisaPublicado e Ativo separados; simulação por canal, calendário humano geral, inatividade, fluxo de encerramento e pesquisa da empresa.
Telefonia · 1.0.44API para eventos, histórico e comandos de um PABX externo por conector. Exige configuração e homologação; não instala uma central telefônica.
Aplicativo e segurançaGuias revisados do Android, notificações, acesso com dois fatores, mídias e limites de disponibilidade por plataforma.
Administração e distribuiçãoOrganização da empresa, departamentos, licenças, usuários da gerência, instalação de clientes e atualização cumulativa com progresso e histórico.
Organização da equipeAgendamento interno de conversas, capacidade na distribuição, presença dos colegas e sequências de ações rápidas.
Central de ajuda da empresaPortal público com artigos próprios, publicação controlada e busca integrada ao chat do site; separado desta Wiki e do conhecimento interno da IA.
FSNET IA na gerênciaEmissão e substituição de chave por empresa, franquia mensal, consumo e conferência de solicitações pendentes no gateway de texto.
WhatsApp · 1.0.61Volumes e custos por número, origem de anúncios e prazos independentes, coluna e filtro de formato dos modelos.
Cobrança da MetaGuia revisado em 07/10/2026 para interpretar mensagens de serviço, franquia mensal, templates e custos sem confundir com consumo de IA.

Passo a passo

  1. Confira a versão efetivamente instalada em Sobre ou Atualizações e os módulos contratados.
  2. Use a relação abaixo para localizar a área que mudou. Abra os guias relacionados para seguir o procedimento completo.
  3. Nas instalações de clientes, use Buscar atualizações quando disponível. Leia as notas antes de solicitar ou agendar uma instalação.
  4. Se uma função estiver documentada como em homologação, aguarde a publicação e a instalação da versão correspondente.
  5. Confira também as permissões do usuário e a configuração do canal. Uma atualização não conecta automaticamente novas contas nem habilita todos os módulos.

Resultado esperado

Você encontra os procedimentos atuais e distingue uma função documentada da versão instalada na sua empresa.

Observações importantes

  • Wiki 1.5.0, revisada em 14/10/2026. A versão do manual é independente da numeração do aplicativo e dos pacotes comerciais.
  • Esta edição considera fontes cumulativas até 1.0.67-pilot e registros de validação da matriz. A inclusão de um recurso no manual não significa que ele esteja instalado na sua empresa.
  • A verificação registrada em 14/10/2026 confirmou a 1.0.67-pilot na matriz e o pacote preparado na gerência. Consulte o painel de sua instalação e a gerência para saber a situação atual de publicação e instalação.
  • Publicar uma atualização não a instala automaticamente nos clientes. A instalação segue a solicitação ou o agendamento do administrador.
  • Os links externos abrem plataformas oficiais. Eles não executam a conexão nem preenchem credenciais no Omnichannel.
  • Os guias e exemplos anteriores continuam nos mesmos endereços. A disponibilidade também depende da licença, permissões e configuração do canal.

Se precisar de ajuda

  • Função ausente: compare versão, perfil, licença e pré-requisitos do artigo.
  • Diferença entre o painel e o guia: informe ao suporte a versão e o título do artigo, sem enviar senhas ou tokens.
  • Falha de atualização: reúna a etapa e a mensagem exibida; não force uma migração ou repita envios de clientes para testar.
Ajuda e aplicativo

Salvar o login no aplicativo e aguardar novas tentativas

Escolha se o app pode guardar a senha neste aparelho e entenda a espera imposta pelo servidor.

Onde encontrarAplicativo → tela de login

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Confira Seu painel, identificador da empresa e e-mail antes de digitar a senha.
  2. Se desejar guardar a credencial em um aparelho sob seu controle, marque Salvar login e senha. A opção começa desmarcada.
  3. Conclua o login e o segundo fator. A gravação acontece somente após autenticação completa.
  4. Em outro acesso, confira os dados preenchidos. Alterar painel, empresa ou e-mail remove a senha restaurada daquele formulário.
  5. Para apagar o login guardado para o painel, desmarque Salvar login e senha. Aguarde o retorno; não é preciso entrar novamente para solicitar a exclusão.
  6. Se aparecer Muitas tentativas, aguarde o contador. Quando terminar, revise os dados e faça uma nova tentativa manual.

Resultado esperado

Você controla a persistência da credencial sem remover as proteções de sessão e autenticação.

Observações importantes

  • A senha fica no armazenamento seguro nativo do aparelho, separada por painel; esta opção não armazena senha no navegador.
  • Salvar login e Confiar neste dispositivo por 30 dias são escolhas independentes. O código do autenticador não é salvo pela opção de login.
  • O prazo do bloqueio vem do servidor. Sem prazo válido informado, o app avisa que o tempo de espera não está disponível.
  • O contador não envia credenciais automaticamente ao terminar. A política do servidor continua valendo após pausa, troca de painel ou reinício do aplicativo.
  • Após troca de senha, remova ou atualize a credencial antiga guardada no aparelho.

Se precisar de ajuda

  • Não foi possível apagar: tente desmarcar novamente e confira se o armazenamento seguro do sistema está disponível.
  • Segundo fator solicitado apesar da senha salva: conclua a verificação; isso não indica perda do login armazenado.
Ajuda e aplicativo

Conferir notificações e push no Android

Confira o registro do aparelho, a permissão do sistema e os avisos relacionados aos seus atendimentos.

Onde encontrarAplicativo → Conta → Notificações

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Entre no painel e na conta corretos e abra Notificações.
  2. Autorize avisos no Android e confira o canal de notificações e o modo silencioso do aparelho.
  3. Verifique a mensagem Push registrado para esta conta e dispositivo. Se o registro estiver pendente, confira a conexão e a configuração com o suporte.
  4. Ao receber um aviso, toque para abrir o atendimento. O app consulta novamente o acesso e o estado da conversa.
  5. Use Marcar todas como lidas para reconhecer os avisos; aguarde o processamento dos lotes.
  6. Confira a leitura no próprio atendimento. Se o aviso continuar, atualize e verifique se ainda há mensagem não lida.

Resultado esperado

O aplicativo apresenta os avisos permitidos e permite acompanhar a confirmação de registro de push.

Observações importantes

  • O Android FSNET usa Firebase e um gateway próprio. O registro e as notificações são vinculados à conta, ao aparelho e ao painel configurado.
  • Com o app aberto, FCM pode gerar aviso e som respeitando o Android. Entrega com app fechado também depende da rede, das permissões e das políticas de bateria do aparelho.
  • Notificações de teste locais não comprovam entrega remota. Não envie mensagens a clientes apenas para testar push.
  • A entrega de notificações com o aplicativo Android fechado foi testada. Permissões, rede e restrições de bateria ainda influenciam cada aparelho.
  • O serviço consulta eventos disponíveis na API; listas limitadas e mudanças rápidas podem restringir a observação. Não use o aviso como substituto do acompanhamento das filas.
  • iOS/APNs e notificações para outro painel dependem de distribuição e configuração próprias; não são ativados ao mudar somente o domínio de login.

Se precisar de ajuda

  • Aviso sem som: confira volume, modo silencioso e canal de notificações no Android.
  • Registro pendente ou sem conexão: confira o painel configurado e tente o login novamente conforme o aviso.
  • Conversa indisponível ao tocar: ela pode ter sido transferida, encerrada ou estar fora da sua permissão atual.
Ajuda e aplicativo

Encontrar orientações na central de ajuda

Busque os artigos públicos que a empresa disponibilizou para os clientes.

Onde encontrarEndereço da central fornecido pela empresa; busca do chat do site quando disponível

Antes de começar

  • Tenha o endereço oficial fornecido pela empresa ou acesso ao chat do site que oferece a busca.

Passo a passo

  1. Abra o endereço oficial da central de ajuda divulgado pela empresa.
  2. Em Como podemos ajudar?, digite uma palavra que descreva sua dúvida e use Buscar.
  3. Abra Ler orientação no artigo desejado. Confira se a instrução corresponde à sua situação.
  4. Use Voltar aos artigos, Anterior ou Próxima para continuar procurando. Se não encontrar uma orientação adequada, procure o canal oficial de atendimento.

Resultado esperado

Você consulta orientações públicas sem precisar de uma conta de atendente.

Observações importantes

  • A empresa escolhe quais artigos publicar. A central pode não estar habilitada em todas as instalações.
  • Pesquisar ou abrir um artigo não cria um chamado nem envia uma mensagem ao atendimento.
  • Não informe senhas ou dados pessoais na busca. Para uma análise individual, use o atendimento oficial.

Se precisar de ajuda

  • Nenhum artigo encontrado: tente uma palavra diferente. Central indisponível: confirme o endereço e o canal de suporte divulgado pela empresa.
Configurar na Meta

Meta: escolher a configuração e seguir o roteiro

Entenda o que cabe ao cliente e o que cabe ao operador do aplicativo.

Onde encontrarOmnichannel → Integrações; Meta Business Suite; Meta for Developers

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Identifique quem fornece o aplicativo Meta: o operador do Omnichannel ou sua própria empresa. Peça ao operador essa confirmação antes de criar outro aplicativo.
  2. Se o aplicativo já é fornecido pelo serviço, o cliente prepara os ativos e autoriza a conexão apresentada no Omnichannel. App Secret, configuração do login e revisão do aplicativo ficam com o operador.
  3. Se a empresa mantém aplicativo próprio, siga os guias de portfólio, aplicativo, permissões, tokens e webhooks antes de conectar o canal.
  4. Para WhatsApp, confira portfólio, WABA e número. Para Instagram, confira a conta profissional. Para Messenger, confira a Página e quem pode administrá-la.
  5. Execute o roteiro específico do canal, confirme sua ativação e só então associe o fluxo publicado.
  6. Homologue recepção e resposta com contato da equipe autorizado. Registre o resultado por canal e não use clientes para testar infraestrutura.

Resultado esperado

Você sabe quais configurações precisa executar e quais deve solicitar ao administrador técnico.

Observações importantes

  • A criação de um aplicativo próprio não é requisito universal de cada cliente.
  • Publicar o aplicativo, verificar a empresa e aprovar permissões são etapas distintas.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Ativo ausente no login: confira a conta Meta usada e os acessos ao portfólio.

Referências oficiais

Configurar na Meta

Meta Business: preparar portfólio e acessos

Organize a propriedade e o acesso aos ativos antes da conexão.

Onde encontrarMeta Business Suite → Configurações do negócio / portfólio empresarial

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Entre no Business Suite com a conta pessoal autorizada a administrar a empresa e selecione o portfólio correto.
  2. Em informações do negócio, confira dados empresariais e os contatos que receberão solicitações de verificação.
  3. Em Pessoas, confira o acesso do administrador responsável. Em Contas, localize a conta WhatsApp, a Página e a conta Instagram que serão utilizadas.
  4. Se um ativo pertence a outra empresa ou prestador, solicite o compartilhamento ou organize a migração com o proprietário. Não crie duplicatas para tentar recuperar acesso.
  5. Na área de segurança ou verificação da empresa, conclua os requisitos que a Meta apresentar para o uso pretendido; envie documentos apenas pelo próprio painel.
  6. Registre internamente o ID do portfólio e os responsáveis. Continue no guia de cada canal.

Resultado esperado

Ativos e responsáveis identificados no portfólio correto.

Observações importantes

  • Ter acesso à Página não implica acesso à WABA.
  • Uma empresa verificada ainda pode precisar de revisão do aplicativo e das permissões.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Verificação pendente: consulte a exigência apresentada pela Meta; o Omnichannel não aprova documentos.
Configurar na Meta

Meta for Developers: preparar o aplicativo próprio

Cadastre os produtos e os dados públicos exigidos para a integração.

Onde encontrarMeta for Developers → Meus aplicativos → aplicativo da empresa

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Confirme que sua empresa será a operadora do aplicativo. Se o serviço já fornece um aplicativo, solicite ao operador os ajustes necessários.
  2. Crie ou abra o aplicativo empresarial compatível com o caso de uso de mensagens apresentado pela Meta e associe o portfólio correto.
  3. Adicione os casos de uso/produtos dos canais contratados: WhatsApp, Instagram ou Messenger. Configure cada produto separadamente.
  4. Em configurações básicas, confira nome, e-mail de contato, domínio e URLs públicas de política de privacidade e de exclusão de dados exigidas para o caso de uso.
  5. Obtenha o App ID e guarde o App Secret em meio reservado. Entregue o segredo apenas ao administrador técnico, no campo protegido correspondente.
  6. Cadastre somente os domínios e endereços de retorno efetivamente usados pelo login do Omnichannel. O endereço da wiki não é o callback de mensagens nem o retorno de autenticação.
  7. Conclua o webhook e as permissões do canal. Verifique os requisitos para publicação e acesso de empresas externas antes de liberar clientes.

Resultado esperado

Aplicativo preparado para a configuração específica de seus canais.

Observações importantes

  • App Secret, token de acesso e token de verificação de webhook têm finalidades diferentes.
  • Não use uma URL genérica de terceiros como política de privacidade da sua empresa.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Produto indisponível: revise o tipo/caso de uso e os requisitos indicados pelo painel Meta.
Configurar na Meta

WhatsApp Manager: localizar WABA e número

Diferencie os identificadores exigidos pela conexão.

Onde encontrarMeta Business → Contas do WhatsApp → WhatsApp Manager; Developers → WhatsApp → Configuração da API

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Campos e opções

CampoComo preencher
Business IDIdentifica o portfólio empresarial.
WABA IDIdentifica a conta WhatsApp Business.
Phone Number IDIdentificador técnico de um número dessa WABA.
TelefoneNúmero visível aos clientes, com DDI e DDD.

Passo a passo

  1. Abra a conta WhatsApp da empresa no WhatsApp Manager e confirme o portfólio proprietário.
  2. Na configuração da API do produto WhatsApp, selecione a conta e o número reais que serão atendidos.
  3. Anote separadamente o ID da conta WhatsApp (WABA ID), o identificador do número (Phone Number ID) e o telefone exibido.
  4. Confira se o ativo é de produção ou um número de teste criado pela Meta. O ativo de teste não concede acesso ao número comercial.
  5. Compare esses dados com a conexão exibida no Omnichannel e corrija a seleção antes da ativação.

Resultado esperado

A integração utiliza a WABA e o identificador do número corretos.

Observações importantes

  • O Phone Number ID não é o telefone com DDI e DDD.
  • O ID do portfólio não substitui o WABA ID.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Número ausente: confira a propriedade e as tarefas atribuídas ao usuário.

Referências oficiais

Configurar na Meta

Meta Business: gerar token e atribuir a WABA correta

Configure a credencial para o aplicativo próprio usar o WhatsApp.

Onde encontrarConfigurações do negócio → Usuários → Usuários do sistema

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Abra o portfólio que administra os ativos e selecione ou crie o usuário do sistema dedicado à integração.
  2. Atribua a esse usuário o aplicativo correto e a conta WhatsApp de produção. Confira o WABA ID; não atribua apenas a conta de teste.
  3. Nas tarefas do ativo, permita as operações utilizadas: consulta do número, mensagens e gestão de modelos quando o sistema precisar criá-los ou excluí-los.
  4. Gere um token para o aplicativo correto com whatsapp_business_messaging e whatsapp_business_management. Peça business_management somente se o fluxo também consultar/administrar os ativos do portfólio.
  5. Revise o prazo oferecido pela Meta. Copie a credencial para o campo protegido indicado pelo responsável técnico; não a publique em chamados ou na wiki.
  6. Confira permissões, validade e ativos acessíveis no depurador de token da Meta e na verificação do canal. Teste também a listagem de modelos da WABA correta.

Resultado esperado

Credencial vinculada ao aplicativo e aos ativos necessários.

Observações importantes

  • Mesmo um token sem expiração programada pode ser revogado.
  • Gerar token não atribui automaticamente os ativos ausentes.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Erro de permissão ao excluir/criar modelo: revise as tarefas da WABA real e o escopo de gestão antes de recriar o canal.

Referências oficiais

Configurar na Meta

WhatsApp: cadastrar, verificar e ativar o número

Conclua a preparação do número e a ativação do atendimento.

Onde encontrarWhatsApp Manager / cadastro integrado Meta → Omnichannel → WhatsApp

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Confirme a situação atual do número: novo, aplicativo WhatsApp Business, outra API ou outro fornecedor. Se já estiver em uso, siga primeiro o guia de migração.
  2. No cadastro da Meta, escolha a WABA correta, preencha o perfil comercial e cadastre o número quando essa for a modalidade apropriada.
  3. Conclua a comprovação de posse pelo método que a Meta disponibilizar. A empresa deve ter acesso ao número para receber o código.
  4. No Omnichannel, finalize a conexão e confira número e conta retornados.
  5. Use Ativar atendimento. Se houver solicitação de registro e PIN de seis dígitos, forneça o PIN adequado e guarde-o com segurança. Se o número já está conectado, não force novo registro.
  6. Leia o diagnóstico de credencial, conta, número e webhook; corrija cada pendência antes de definir o canal como pronto.
  7. Confira o perfil comercial e as condições de cobrança/qualidade na Meta. Realize a homologação autorizada antes de divulgar o canal.

Resultado esperado

Número conectado e diagnóstico de ativação concluído.

Observações importantes

  • O código recebido por SMS/voz, o PIN do número e o código do autenticador pessoal são diferentes.
  • Nome de exibição e disponibilidade podem depender de análise da Meta.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • PIN desconhecido ou número em outro provedor: utilize o procedimento de recuperação/migração aplicável; não exclua o número para tentar liberar.
Configurar na Meta

Cadastro integrado: autorizar o WhatsApp pela Meta

Selecione os ativos pelo login oficial e finalize a conexão no painel.

Onde encontrarOmnichannel → Integrações → WhatsApp → conexão pela Meta

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Entre no Omnichannel como administrador e inicie a conexão pela Meta disponibilizada pela instalação.
  2. Na janela oficial, autentique a conta com acesso ao portfólio da empresa; se o navegador bloquear a janela, permita-a para o domínio do painel.
  3. Revise a empresa, a WABA e o número escolhidos em cada etapa. Autorize os acessos correspondentes à integração.
  4. Conclua as verificações solicitadas pela Meta e volte ao Omnichannel sem fechar prematuramente o fluxo.
  5. Confira os ativos retornados e execute Ativar atendimento para confirmar a operação.
  6. Se a empresa usa ativos do mesmo portfólio proprietário do aplicativo e o fluxo recusar essa combinação, peça ao operador que configure a modalidade própria com usuário do sistema. Não troque a propriedade de ativos só para contornar o aviso.

Resultado esperado

Autorização salva para os ativos escolhidos, seguida da ativação efetiva.

Observações importantes

  • O operador configura o aplicativo e o retorno autorizado do login. O cliente utiliza os botões do Omnichannel, sem editar o servidor durante o cadastro integrado.
  • A conexão manual atual aceita WABA, ID do número e token da API existente. As credenciais precisam pertencer aos ativos autorizados; valide antes de confirmar a ativação.
  • Adicionar outro número não exige desconectar os números que já estão atendendo. Confira o cartão e o número escolhido antes de ativar, alterar ou desconectar.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.
  • Inicie Conectar automaticamente no Omnichannel para concluir a autorização com o retorno correto. Abrir o painel externo serve para preparar e administrar a conta; não conecta o canal por si só. O cliente não precisa criar outro aplicativo Meta quando utiliza o aplicativo já oferecido pelo fornecedor.

Se precisar de ajuda

  • Login concluiu, mas canal não atende: confira o diagnóstico e o webhook.
  • Erro de domínio/retorno: envie o aviso ao operador do aplicativo.
Configurar na Meta

Meta Developers: configurar o webhook do WhatsApp

Direcione eventos de mensagens para o servidor do Omnichannel.

Onde encontrarDevelopers → aplicativo → WhatsApp → Configuração / Webhooks

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Solicite ao responsável técnico a URL HTTPS pública exata de recepção e o token de verificação configurado no Omnichannel. Não use o domínio da wiki.
  2. Na configuração de webhook do produto WhatsApp, informe a URL e o token de verificação correspondentes e execute a validação.
  3. No objeto WhatsApp Business Account, confira a assinatura do campo messages e dos eventos adicionais que o administrador indicar para os recursos utilizados.
  4. No Omnichannel, execute a ativação/verificação para confirmar a assinatura do aplicativo na WABA correta. Salvar a URL no aplicativo e assinar a conta são verificações diferentes.
  5. Se já havia outro fornecedor, solicite revisão dos callbacks específicos do número e da WABA: um override pode prevalecer sobre o callback geral do aplicativo.
  6. Homologue com uma conversa de teste autorizada. Confira tanto a chegada ao painel quanto o status de resposta e os registros de webhook.

Resultado esperado

Eventos da WABA correta chegam ao Omnichannel e o diagnóstico confirma a assinatura.

Observações importantes

  • O token de verificação apenas valida o callback; ele não é o token de acesso à Graph API.
  • Uma nova assinatura manual pode afetar overrides existentes; prefira o procedimento de ativação da instalação.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Validação recusada: confira HTTPS, URL, token e acesso público ao endpoint.
  • Validação aceita sem mensagens: confira assinatura da WABA, overrides e número selecionado.

Referências oficiais

Configurar na Meta

WhatsApp Manager: criar e acompanhar modelos

Prepare templates que poderão ser usados nos atendimentos e cobranças.

Onde encontrarWhatsApp Manager → Modelos de mensagem; Omnichannel → Modelos WhatsApp

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. No WhatsApp Manager, escolha a WABA vinculada ao canal e abra a gestão de modelos.
  2. Crie um modelo com nome, idioma e categoria adequados à finalidade real da mensagem.
  3. Preencha texto, cabeçalho, rodapé e botões quando necessários. Para variáveis e mídia, forneça exemplos no formato solicitado pela Meta.
  4. Revise a mensagem e envie para análise. Aguarde o status de aprovação; um rascunho ou modelo rejeitado não está liberado para envio.
  5. Volte ao Omnichannel e atualize a listagem. Confira nome, idioma e parâmetros do modelo aprovado.
  6. Faça uma homologação autorizada conferindo a ordem das variáveis, links, anexos e resultado. Só então utilize-o em campanha ou rotina IXC.
  7. Acompanhe rejeições, pausas e qualidade na Meta. Ajuste a causa apontada e submeta a versão corrigida quando cabível.

Resultado esperado

Modelo aprovado e compatível com os parâmetros que o Omnichannel enviará.

Observações importantes

  • A categoria é analisada pela Meta.
  • Excluir um modelo usado em rotinas pode interromper cobranças e campanhas.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Modelo não aparece: confira WABA, idioma, aprovação e permissão do token.
  • Parâmetros recusados: compare componentes do template com os campos da rotina.
Configurar na Meta

Instagram: preparar conta profissional e acesso

Configure os requisitos de Instagram Login utilizados na integração.

Onde encontrarInstagram → configurações da conta; Developers → aplicativo → Instagram

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Confirme que a conta é profissional, do tipo Empresa ou Criador, e que você tem autorização para administrá-la.
  2. Identifique a modalidade utilizada pela instalação. O Instagram Login direto utiliza credenciais e permissões próprias; não o misture com a modalidade Facebook Login.
  3. No aplicativo Meta, configure o produto Instagram e obtenha os dados do aplicativo Instagram apresentados nessa área.
  4. Para homologação restrita, adicione a conta nas funções/testadores que o painel exigir e aceite o convite na conta Instagram, em permissões de sites/aplicativos quando apresentado.
  5. Na configuração da API, autorize a conta em Adicionar conta / Gerar token, ou utilize a conexão integrada do Omnichannel se habilitada.
  6. Confirme as permissões instagram_business_basic e instagram_business_manage_messages. Confira também o controle de acesso a mensagens nas configurações da conta, quando disponível.
  7. Cadastre no Omnichannel o ID profissional e a credencial retornados pelo mesmo fluxo. Na configuração técnica direta, use graph.instagram.com e o segredo do aplicativo Instagram correspondente.
  8. Continue no guia de webhook e confira os requisitos de publicação/revisão para atender usuários externos.

Resultado esperado

Conta profissional autorizada com credencial compatível com Instagram Login.

Observações importantes

  • Na alternativa Facebook Login, a conta profissional precisa do vínculo com Página e de permissões próprias dessa modalidade.
  • Token WhatsApp e ID de usuário do sistema não substituem token e ID profissional Instagram.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Convite pendente: aceite-o pela conta convidada.
  • Token inválido: confira a modalidade, o aplicativo emissor e a conta retornada.

Referências oficiais

Configurar na Meta

Instagram: cadastrar callback e assinar mensagens

Finalize a recepção de mensagens diretas no Omnichannel.

Onde encontrarDevelopers → Instagram → Webhooks; Omnichannel → Integrações → Instagram

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. No Omnichannel, confira nome da conta, ID profissional, token, segredo do aplicativo e a versão/base Graph adotada pela instalação.
  2. Use Testar, salvar e assinar na configuração direta, ou conclua a ativação na conexão integrada, conforme a tela disponível.
  3. Copie a URL de webhook e o token de verificação apresentados pelo sistema. A rota da integração é /api/v1/webhooks/instagram no domínio público do Omnichannel.
  4. No produto Instagram do aplicativo, cadastre esses valores e confirme a validação.
  5. Confira os eventos messages, messaging_postbacks e messaging_seen. Volte ao Omnichannel e utilize Assinar novamente se a assinatura ainda estiver pendente.
  6. Verifique o status do aplicativo e os acessos permitidos pelo modo atual na Meta. Homologue uma mensagem direta recebida e uma resposta para a conta autorizada.
  7. Associe o fluxo publicado ao canal e repita a conferência da fila e da transferência para a equipe.

Resultado esperado

Mensagens diretas chegam ao canal Instagram configurado.

Observações importantes

  • Salvar um token não garante que a assinatura de eventos foi concluída.
  • As condições de teste e publicação devem ser verificadas no painel atual da Meta.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Callback valida, mas nada chega: confira conta, eventos, assinatura e autorização para o usuário remetente.
  • Erro de assinatura: confira o App Secret do produto Instagram.

Referências oficiais

Configurar na Meta

Facebook: configurar Página e token do Messenger

Prepare a Página, as permissões e o token usados pelo atendimento.

Onde encontrarMeta Business → Páginas; Developers → Messenger → Configuração da API

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Escolha a Página da empresa e confirme que o administrador que autorizará a conexão pode executar a tarefa de mensagens.
  2. No aplicativo correto, configure o produto Messenger e autorize a Página na área de configuração da API ou pelo login integrado oferecido pelo Omnichannel.
  3. Obtenha um token de acesso da Página, confirmando pages_messaging e as permissões de assinatura/gestão exigidas, como pages_manage_metadata. pages_show_list é utilizada quando o fluxo precisa listar Páginas.
  4. Se o produto consulta nome e foto dos remetentes, confira o acesso Business Asset User Profile Access. Permissões de leitura de conteúdo da Página só devem ser solicitadas quando a função realmente as utiliza.
  5. Confira o Page ID e o token da mesma Página. Na configuração direta do Omnichannel, informe esses dados, o App Secret correspondente e graph.facebook.com.
  6. Salve/teste a conexão e prossiga para o webhook. Conclua a revisão necessária antes de disponibilizar o aplicativo a empresas e usuários externos.

Resultado esperado

Página autorizada para o atendimento com credencial própria do Messenger.

Observações importantes

  • Um token de usuário ou de WhatsApp não substitui automaticamente o token da Página.
  • Conectar uma Página não concede acesso a todas as Páginas do portfólio.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Página ausente: confira permissões do usuário que autorizou o login e a seleção dos ativos.

Referências oficiais

Configurar na Meta

Messenger: cadastrar webhook e eventos da Página

Conclua a entrega de mensagens da Página ao Omnichannel.

Onde encontrarDevelopers → Messenger / Webhooks → Página; Omnichannel → Messenger

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Copie do Omnichannel a URL HTTPS e o token de verificação do canal Messenger. A rota é /api/v1/webhooks/messenger no domínio do painel.
  2. No webhook do produto Messenger/Página, cadastre o callback e valide com o token informado.
  3. Confira os eventos usados pela instalação: messages, messaging_postbacks, message_deliveries, message_reads, messaging_optins e messaging_referrals.
  4. No Omnichannel, conclua a assinatura da Página pelo comando de teste/ativação ou Assinar novamente quando necessário.
  5. Peça a um contato autorizado para homologação que inicie uma conversa com a Página. Confira a recepção no painel e a resposta dentro das condições permitidas pelo canal.
  6. Revise o fluxo de entrada, setor e disponibilidade da equipe antes de colocar o atendimento em operação.

Resultado esperado

Página assinada e mensagens chegando ao canal Messenger correto.

Observações importantes

  • A autorização da Página e a validação do callback são etapas separadas.
  • O canal tem regras de janela de mensagens e permissões próprias.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Sem eventos: confira Page ID, assinatura e modo do aplicativo.
  • Mensagem recebida sem resposta: consulte o erro do envio e o token da Página.

Referências oficiais

Configurar na Meta

Meta: revisão do aplicativo e liberação para clientes

Organize a passagem de teste para uso externo conforme o caso de uso.

Onde encontrarDevelopers → Revisão do aplicativo / Permissões e recursos; Business → verificação

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Liste os recursos realmente utilizados por cada canal e as permissões exigidas pelo login e pelas operações.
  2. Confira no painel quais permissões precisam de acesso avançado ou revisão para os usuários e negócios que serão atendidos.
  3. Complete as informações públicas, política de privacidade, exclusão de dados e verificação empresarial que a Meta solicitar.
  4. Prepare as instruções de teste e a gravação demonstrativa do uso de cada permissão. Mostre conexão, recepção e resposta com contas de homologação; não inclua credenciais reais na gravação.
  5. Para atendimento a empresas de terceiros, confira também os requisitos de provedor tecnológico e verificação de acesso aplicáveis ao operador.
  6. Envie a solicitação, acompanhe a decisão e corrija os pontos explicitamente solicitados.
  7. Depois das aprovações necessárias, confira o estado de publicação do aplicativo e homologue com uma conta elegível fora das funções de desenvolvedor. Registre quais canais foram liberados.

Resultado esperado

Aplicativo com os acessos e o estado necessários ao público pretendido.

Observações importantes

  • Uma conta empresarial verificada não equivale a aplicativo aprovado.
  • Ser testador não comprova liberação para todos os clientes.
  • A aprovação depende da Meta.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Revisão recusada: confronte a justificativa com a demonstração e o escopo solicitado; não peça permissões sem uma função correspondente.
Configurar na Meta

WhatsApp: migrar de fornecedor e avaliar coexistência

Planeje a troca sem perder o controle do número e do atendimento.

Onde encontrarWhatsApp Manager; provedor atual; administrador técnico do Omnichannel

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Registre propriedade do portfólio, WABA, número, aplicativo atual e responsáveis. Identifique se há API de outro fornecedor ou aplicativo WhatsApp Business.
  2. Confirme a modalidade de migração/coexistência oferecida pela Meta para esse número e se o seu serviço a suporta. Não exclua o número ou a conta para tentar liberar acesso.
  3. Combine uma janela de mudança e o procedimento de retorno. Registre fluxos, templates, callbacks e automações que precisam ser revisados.
  4. Confirme separadamente o que será preservado: número, modelos e histórico têm tratamentos diferentes. A integração consultada não garante importação de histórico nem sincronização de mensagens do aplicativo em coexistência.
  5. Execute o cadastro/migração autorizado com o administrador técnico, revisando assinatura e possíveis overrides de webhook.
  6. Evite que duas automações respondam simultaneamente. Homologue entrada, resposta, modelo aprovado e encaminhamento humano no novo canal.
  7. Somente após a validação, finalize a transição combinada com o provedor anterior e monitore falhas e qualidade.

Resultado esperado

Mudança planejada e canal validado no destino, com limites de preservação conhecidos.

Observações importantes

  • Coexistência não significa que todos os eventos e recursos do aplicativo móvel estarão disponíveis no painel.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Número bloqueado por vínculo anterior: confirme o procedimento de migração com o provedor; não tente sucessivos registros às cegas.
Configurar na Meta

Meta: renovar credenciais e resolver permissões

Diagnostique expiração, ativos ausentes e assinatura antes de recriar canais.

Onde encontrarOmnichannel → diagnóstico do canal; Meta → depurador de token e acessos

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Anote horário, canal e mensagem de erro sem copiar o token para registros públicos.
  2. Confira no painel oficial a validade, o aplicativo emissor e os escopos da credencial.
  3. Revise se o usuário continua autorizado ao ativo real: WABA de produção, conta Instagram ou Página.
  4. Renove pela mesma modalidade que originou a conexão: reconexão integrada, token de sistema, Instagram Login ou token de Página.
  5. Atualize o campo protegido da integração e execute a verificação/ativação; confirme novamente a assinatura de eventos.
  6. Homologue recepção e resposta com contato autorizado. Quando a troca estiver validada, revogue a credencial anterior conforme o procedimento de manutenção.

Resultado esperado

Credencial e ativos coerentes com o canal em operação.

Observações importantes

  • Mudar senha, revogar integração ou retirar acesso a ativos pode invalidar a autorização.
  • App Secret não deve ser trocado como tentativa genérica de corrigir um token expirado.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Erro persiste com novo token: confira o ativo, o aplicativo e a assinatura antes de excluir qualquer cadastro.
Configurar no IXC

IXC: entender as duas integrações e seus tokens

Separe consulta ao ERP e envio do ERP para o Omnichannel.

Onde encontrarIXC → usuário de API e Integrações Omnichannel; painel → Integrações → IXC

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Campos e opções

CampoComo preencher
Omnichannel → IXCToken criado no ERP; URL https://SEU-IXC/webservice/v1.
IXC → OmnichannelCredencial criada na ponte; copie sua URL sem remontar o endereço.

Passo a passo

  1. Para consultar cliente, contratos e financeiro no ERP, crie a credencial no IXC e cadastre-a em Integrações → IXC Soft no Omnichannel.
  2. Para o IXC consultar canais/modelos e solicitar envios, gere outra credencial na ponte Omnichannel e cadastre-a em Integrações Omnichannel no IXC.
  3. Confira a URL em cada sentido: a API do ERP termina em /webservice/v1; a ponte usa a URL completa exibida pelo Omnichannel.
  4. Valide primeiro a leitura do ERP e a consulta de canais/modelos, de forma independente.
  5. Somente depois configure o teste de envio e a liberação de produção da ponte.

Resultado esperado

Cada token está no sistema correto e pode ser diagnosticado de forma independente.

Observações importantes

  • Não copie o token da API IXC para o campo de token da ponte.
  • A ponte implementa canais, modelos e envio compatível; não oferece todas as funções do Opa! Suite.

Se precisar de ajuda

  • Consultas funcionam, mas cobrança não envia: confira a ponte e seus controles de envio.

Referências oficiais

Configurar no IXC

IXC: criar usuário de API e obter o token

Prepare uma identidade exclusiva para o Omnichannel consultar o ERP.

Onde encontrarIXC → Configurações → Usuários → Usuário

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Acesse o IXC da sua empresa em Configurações → Usuários → Usuário. Crie ou edite um usuário exclusivo para o Omnichannel.
  2. Vincule esse usuário ao grupo de permissões previsto para a integração. Habilite Permite acesso a API e salve para gerar o Token de acesso.
  3. No Omnichannel, abra Integrações → IXC Soft → Editar informações. Preencha a URL https://SEU-IXC/webservice/v1/ e o token completo, preservando o separador de dois-pontos. Não transforme o token em Base64.
  4. Use Salvar IXC e confira o retorno. Homologue uma consulta autorizada de cliente e os recursos que a operação utilizará.
  5. Registre o responsável pela credencial. Se o e-mail ou a senha desse usuário forem alterados no IXC, confira o token e atualize o Omnichannel quando necessário.

Resultado esperado

Credencial exclusiva cadastrada e consulta ao ERP validada.

Observações importantes

  • O token permite somente as ações autorizadas ao grupo do usuário.
  • Não utilize a senha de login no lugar do Token de acesso.

Se precisar de ajuda

  • Falha de autenticação: confira o usuário ativo, a credencial integral e o grupo.
  • Falha de conexão: siga o guia de rede.

Referências oficiais

Configurar no IXC

IXC: configurar grupo e permissões por recurso

Autorize as consultas e ações realmente implementadas no conector.

Onde encontrarIXC → Configurações → Usuários → Grupo de usuários → Permissões

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Campos e opções

CampoComo preencher
Cadastro e contratoLeitura: cliente, cliente_contrato, vd_contratos_produtos.
Financeiro e fiscalLeitura: fn_areceber, vd_saida; obtenção de documentos depende também das rotinas específicas.
Acesso e redeLeitura: radusuarios, radacct, radpop_radio_cliente_fibra, tv_usuarios.
Atendimento e catálogosLeitura: su_ticket, su_oss_chamado, su_oss_assunto, empresa_setor, funcionarios, filial.
Abertura de OSInclusão em su_oss_chamado quando o módulo for utilizado.
DesbloqueioAção desbloqueio_confianca; sujeita à elegibilidade e regras do ERP.

Passo a passo

  1. Crie um grupo dedicado e vincule o usuário da integração a ele.
  2. Na aba de permissões, associe os recursos da tabela às telas equivalentes da sua versão do ERP. Libere consulta/listagem para os módulos contratados.
  3. Se a operação abrir ordens de serviço pelo Omnichannel, permita a inclusão de su_oss_chamado. A lista de escrita do conector não libera alterações arbitrárias nas demais tabelas.
  4. Trate desbloqueio de confiança e obtenção de documentos como ações específicas: valide também as regras e permissões que o ERP exigir para elas.
  5. Execute homologação por função: cliente, contrato, fatura, documento, login, catálogo de OS e, apenas com autorização, abertura de OS ou desbloqueio.
  6. Se uma função falhar, identifique o recurso negado e ajuste a permissão correspondente antes de repetir a operação.

Resultado esperado

Grupo compatível com os módulos usados, com operações de escrita explicitamente delimitadas.

Observações importantes

  • A tabela descreve recursos utilizados pelo código consultado; os nomes das permissões de tela podem variar no IXC.
  • Consulta financeira não dá autorização para baixar pagamentos.

Se precisar de ajuda

  • Consulta funciona parcialmente: confira o recurso específico e o escopo do cadastro/filial.

Referências oficiais

Configurar no IXC

IXC: liberar rede e conferir o endereço da API

Verifique o caminho entre o servidor Omnichannel e o ERP.

Onde encontrarIXC → Grupo de usuários → Permissão de login → Redes permitidas

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Peça ao administrador técnico o IP público de saída do servidor Omnichannel que efetivamente consulta o IXC. O IP do seu computador e o da wiki podem ser diferentes.
  2. No grupo dedicado, cadastre a rede/IP autorizado no campo Redes permitidas e salve. Preserve os acessos existentes necessários caso o grupo seja compartilhado.
  3. Confirme com o responsável pela infraestrutura que DNS, certificado HTTPS e firewall permitem a comunicação do servidor com a API do ERP.
  4. Confira no Omnichannel a URL completa terminada em /webservice/v1, sem endereço de tela administrativa ou credenciais na URL.
  5. Execute Testar e salvar pelo Omnichannel e depois uma consulta de cliente. Testar apenas no navegador do seu computador não valida a origem do servidor.

Resultado esperado

Servidor autorizado e API acessível pelo caminho usado pela integração.

Observações importantes

  • O endereço da API não apresenta a interface normal do ERP.
  • Não desabilite a verificação do certificado para contornar erro de HTTPS.

Se precisar de ajuda

  • Timeout: confira origem, firewall e disponibilidade.
  • Acesso negado: confira grupo, rede e credencial.

Referências oficiais

Configurar no IXC

IXC: cadastrar a ponte em Integrações Omnichannel

Preencha o gateway que consulta canais e modelos do Omnichannel.

Onde encontrarOmnichannel → Integrações → IXC → ponte; IXC → Configurações → Integrações → Integrações Omnichannel

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. No Omnichannel, abra a ponte, use Gerar credencial e copie o valor exibido uma única vez. Ative a consulta e mantenha os envios bloqueados nesta etapa.
  2. Copie a URL exata apresentada. Nesta implementação, seu caminho é /api/ixc-bridge/api/v1 no domínio público do Omnichannel.
  3. No IXC, abra Integrações Omnichannel, escolha Novo e dê uma descrição que identifique o Omnichannel.
  4. Selecione o gateway Opa! Suite para o formato compatível. Cole a URL da ponte e a credencial gerada no Omnichannel, sem utilizar o token de consulta do ERP.
  5. Revise Utiliza fila de mensagens de acordo com a rotina que será homologada e salve. A escolha precisa ser validada com o processamento da sua versão do IXC.
  6. Confira a listagem de canais e templates na rotina de envio do IXC. Ainda não substitua a integração padrão usada por cobranças em operação.

Resultado esperado

Cadastro da ponte disponível para a homologação de canais e modelos.

Observações importantes

  • O nome do gateway indica compatibilidade de formato. Não é preciso gerar uma credencial no Opa para essa ponte Omnichannel.
  • Dashboard do cliente e demais funções Opa não estão garantidas pela ponte.

Se precisar de ajuda

  • Canal ausente: confira WhatsApp ativo, consulta habilitada e empresa da credencial.
  • Token perdido: use Trocar credencial e atualize o cadastro do IXC.

Referências oficiais

Configurar no IXC

IXC: homologar a ponte com destinatário restrito

Teste um modelo sem liberar envios gerais aos clientes.

Onde encontrarOmnichannel → ponte IXC; IXC → rotina de mensagem configurada

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Escolha um telefone da equipe com autorização para receber a homologação e informe-o na ponte com DDI e DDD.
  2. Confira que a consulta está ativa, o modo de produção está desativado e o destinatário permitido é o esperado.
  3. Use Liberar teste. Confira no painel a indicação de envio restrito.
  4. No IXC, selecione o canal e um template aprovado; preencha as variáveis e, se houver, o documento de teste correspondente.
  5. Execute uma única solicitação autorizada para o telefone permitido. Confira a fila do IXC, o registro da ponte e a entrega no contato de teste.
  6. Revise a renderização dos valores, links e documentos. Não repita automaticamente quando o resultado for incerto; consulte o status primeiro.
  7. Ao encerrar a homologação, use Bloquear envio se a operação ainda não será liberada.

Resultado esperado

Solicitação validada no destinatário permitido, com resultado rastreável.

Observações importantes

  • No modo restrito, a ponte recusa destinatários fora da lista permitida.
  • Uma consulta bem-sucedida de modelos não prova o envio.

Se precisar de ajuda

  • Envio desativado: confira Liberar teste.
  • Destinatário recusado: confira o número permitido sem liberar produção apenas para contornar o teste.
Configurar no IXC

IXC: liberar produção e definir a integração padrão

Coloque a ponte em operação depois da homologação de cada rotina.

Onde encontrarOmnichannel → ponte IXC; IXC → Configurações → Parâmetros → Parâmetros Gerais → Integrações

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Confirme a homologação de canal, modelo, parâmetros, documento, destinatário e comportamento da fila. Registre quem autorizou a entrada em operação.
  2. No IXC, identifique a integração padrão atual e as rotinas que dependem dela. Guarde sua referência para eventual retorno.
  3. No Omnichannel, confira o canal ativo, a consulta habilitada e os controles de envio. Use Liberar produção para permitir destinatários além do teste quando a operação estiver autorizada.
  4. No IXC, em Parâmetros Gerais → Integrações, selecione o cadastro Omnichannel no campo Integração Opa! Suite quando a operação for usar esse padrão e salve.
  5. Confira as rotinas de cobrança uma a uma: canal, modelo, critérios, horários e fila. A troca do padrão pode redirecionar rotinas existentes.
  6. Acompanhe os primeiros envios operacionais autorizados pelos registros e indicadores, sem criar mensagens adicionais apenas para testar infraestrutura.
  7. Se houver falha relevante, bloqueie os envios na ponte, revise filas pendentes e restaure a seleção anterior quando aplicável. Evite reprocessamento em lote antes de reconciliar o que já foi enviado.

Resultado esperado

Ponte liberada para a operação aprovada e integração padrão conferida no ERP.

Observações importantes

  • Liberar produção amplia o alcance além do telefone de teste.
  • Desativar produção retorna à restrição de teste; para interromper todo envio, use Bloquear envio.
  • A ponte não faz baixa financeira.

Se precisar de ajuda

  • Falhas após mudar o padrão: confira o cadastro selecionado e os modelos; preserve os registros antes de reprocessar.

Referências oficiais

Configurar no IXC

IXC: preparar modelos e rotinas de cobrança

Confira os dados que o ERP enviará pelo canal oficial.

Onde encontrarIXC → rotina financeira de envio Omnichannel; Omnichannel → modelos e ponte

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Identifique a rotina financeira que sua empresa já utiliza e o responsável por seus critérios de seleção. Confirme o cadastro da integração e o canal utilizados por ela.
  2. Escolha um template aprovado da WABA do canal. Confira nome, idioma, cabeçalho, texto e botões.
  3. Mapeie cada parâmetro da rotina para a posição esperada pelo template: nome, vencimento, valor, link e demais campos efetivamente presentes.
  4. Se houver PDF ou Pix, confirme que o IXC disponibiliza os dados/documentos e que o modelo aceita o componente enviado. Use dados de homologação compatíveis.
  5. Revise quais títulos entram na rotina, o telefone do destinatário, o agendamento e o uso da fila. Garanta que não há outra rotina enviando a mesma cobrança.
  6. Homologue pelo modo restrito da ponte. Confira o documento e os parâmetros recebidos, além do status retornado ao ERP.
  7. Libere a rotina operacional somente depois da validação e acompanhe falhas, pausas de modelos e solicitações de não recebimento.

Resultado esperado

Rotina e template compatíveis, com parâmetros e documentos conferidos.

Observações importantes

  • A ponte transforma canais e templates para o formato esperado pelo ERP; não corrige uma configuração financeira equivocada.
  • Carteira bancária, emissão e conciliação continuam no IXC e dependem do banco/contrato da empresa.

Se precisar de ajuda

  • Modelo listado mas envio falha: confira componentes e idioma.
  • Pix/PDF ausente: confira a emissão no ERP antes de alterar o canal.
Configurar no IXC

IXC: preparar cadastros para consultas e abertura de OS

Organize os dados que o cliente e o atendente utilizam no Omnichannel.

Onde encontrarIXC → cadastros de clientes, contratos, logins e catálogos de atendimento

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. No cliente de homologação, confira documento e telefones, evitando duplicidade de dados que torne a identificação ambígua.
  2. Confira os contratos vinculados, sua situação e os logins de acesso correspondentes.
  3. Para ordens de serviço, revise assuntos, setores, técnicos e filiais que poderão ser selecionados. Confirme que os cadastros estão ativos e acessíveis ao usuário API.
  4. No Omnichannel, identifique o cliente e confira o contrato/logins exibidos antes de consultar financeiro ou suporte.
  5. Abra o formulário de OS e verifique os catálogos retornados. A abertura real deve ocorrer somente para uma solicitação autorizada.
  6. Após criar uma OS autorizada, confirme seu identificador no ERP e a associação ao cliente/contrato correto.

Resultado esperado

Cadastros consistentes e opções de OS disponíveis à operação.

Observações importantes

  • Atualizar o cadastro no IXC e vincular o contato no Omnichannel são tarefas diferentes.
  • Não use uma OS fictícia em produção para testar infraestrutura.

Se precisar de ajuda

  • Catálogo vazio: confira permissão, status e escopo da filial.
  • Mais de um contrato: selecione o serviço correto antes de agir.
Configurar no IXC

IXC: validar boleto, Pix, nota fiscal e desbloqueio

Confira no ERP os pré-requisitos das ações disponíveis no atendimento.

Onde encontrarIXC → cliente → contratos e financeiro; Omnichannel → contexto do cliente

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. Confira no ERP um cliente autorizado com contrato e títulos conhecidos. Compare situação, vencimento e valores antes de homologar a consulta.
  2. Para boleto/Pix, confirme que a cobrança foi emitida e possui linha digitável, código Pix ou documento conforme a carteira e a rotina utilizada.
  3. Para documento fiscal, confirme que a nota foi emitida e que o PDF está disponível na rotina suportada. A consulta no Omnichannel não cria uma nota nova.
  4. Revise as permissões da credencial e as preferências do Omnichannel para contratos inativos, separação por contrato e período de notas fiscais.
  5. Para desbloqueio de confiança, verifique as regras de elegibilidade no IXC e confirme a identificação, o contrato e a solicitação antes da ação.
  6. Compare o resultado do painel com o retorno do ERP. Trate ausência de documento, recusa e indisponibilidade como resultados distintos.
  7. Encaminhe configurações de carteira, banco, emissão fiscal e políticas comerciais ao administrador responsável pelo ERP quando estiverem pendentes.

Resultado esperado

Ações de atendimento usam os dados e as regras realmente disponíveis no ERP.

Observações importantes

  • Desbloqueio não confirma pagamento.
  • A integração não substitui configuração bancária, fiscal ou conciliação do IXC.

Se precisar de ajuda

  • Documento não encontrado: confirme emissão e período de consulta.
  • Desbloqueio recusado: leia a regra retornada pelo ERP; não altere a situação financeira para contornar.