Guia de configuração isobot no ambiente
Pré-requisitos para configuração da classificação do chat:
Cliente “anônimo” cadastrado.
Parâmetro “SMTPCONFIG” configurado e ativo.
Acesso ao Provedor.
Webhook configurado dentro do Provedor.
Nesse guia você irá aprender a como configurar passo a passo o isoBot dentro do ambiente.
Um número Whatsapp/Telegram para cada menubot (menu) no isoBot;
Todos os canais (Whatsapp, Messenger, Telegram e Instagram respondem ao mesmo (único) menu de navegação no isoBot; Caso necessite um menu diferente para cada canal, precisa de uma customização e criação de mais menus (isoBot).
Instagram + Messenger Facebook não necessitam de número celular ativo.
# PASSO 1 - Criar uma classificação de chat de acordo com o que tu queres configurar, no exemplo será usado a inclusão da classificação WhatsApp:
Para isso siga o seguinte caminho, supervisor -> chat -> classificação:
Clicar em incluir:
Depois abrirá a seguinte tela, e será necessário preencher da seguinte forma:
Após alterar e configurar esses campos, clique em “inserir” 2x, e volte para a página de classificação, e estará configurado.
# PASSO 2 - Criar a classificação de chat “ISOCHAT BOT”:
Para isso siga o seguinte caminho, supervisor -> chat -> classificação -> Incluir:
Criar da seguinte forma:
Clique em inserir duas vezes, e está configurado.
# PASSO 3 - Criar o parâmetro “ISOCHATBOT”:
Para isso abra o menu de parâmetros:
Clique na opção “Adicionar parâmetro”
Crie ele da seguinte forma:
Parâmetro = ISOCHATBOT
Descrição = ISOCHATBOT
Observação = (Deixa em branco)
Ativo = Marca essa opção
Clica em Salvar
Agora filtre o parâmetro que acabou de criar, e vá no lápis para que consiga abrir a opção de configuração e possa incluir um novo usuário a esse parâmetro:
Adicione o usuário “ISOPADRAO”. Todos os detalhes deverão ser adicionados a este usuário.
Sempre “Ordem” = 1 e deixe ativo e clique em salvar.
Expanda a opção de usuário dentro do parâmetro para configurarmos os ambientes necessários para que seja funcional:
Depois de clicar no lápis abrirá uma tela de detalhes em branco, e tu terá que adicionar os seguintes detalhes, sempre clicando na opção “Adicionar Detalhe”
A tela que abrirá seguirá esse padrão e terá de ser preenchida com a seguinte ordem:
1º Detalhe para adicionar:
Pergunta: CLASS_CHAT_ATENDIMENTO
Resposta: (Você precisa ir até a tela de classificação de chat, passar o mouse por cima da “lupa” e observar o número que aparece no rodapé da página esse número ‘11’ após a virgula, é o número que tu colocarás de resposta, no caso do exemplo, é o ‘11’, mas no ambiente que estiver cadastrando a classificação de chat WhatsApp pode ter sido a terceira a ser criada, então a resposta seria ‘3’, por isso é importante observar esse detalhe.)
Observação: (Deixa em Branco se quiser)
Ordem: 1
Ativo: Marca essa opção
Clica em salvar.
Ficará da seguinte forma
A tela que abrirá seguirá esse padrão e terá de ser preenchida com a seguinte ordem:
2º Detalhe para adicionar:
Pergunta: CLASS_CHAT_BOT
Resposta: Passar o mouse em cima da lupa para visualizar qual número representa a classificação “ISOCHAT BOT” que foi criada anteriormente,
nossa resposta nesse exemplo será ‘12’
Observação: (Deixa em Branco se quiser)
Ordem: 1
Ativo: Marca essa opção
Clica em salvar.
Ficará da seguinte forma:
3º Detalhe para adicionar:
Pergunta: PROVEDOR_TOKEN
Resposta: Precisa colar o token de acesso ao provedor, e para isso precisará acessar o provedor Provedor -> login e senha -> Menu na aba lateral -> opção ‘Canais e Integrações’ -> ‘Provedor API’ e copia o campo de “Acessar Token”:
Cole esse token no campo de Resposta.
Observação: Copie novamente o token de acesso e cole aqui
Ordem: 1
Ativo: Marca essa opção
Clica em salvar.
Ficará da seguinte forma:
5º Detalhe para adicionar:
Pergunta: PROVEDOR_PHONE
Resposta: É o número que foi cadastrado como WhatsApp bussines
Observação: (Deixa em branco)
Ordem: 1
Ativo: Marca essa opção
Clica em salvar.
Ficará da seguinte forma:
5º Detalhe para adicionar:
Pergunta: PROVEDOR_ACCOUNT
Resposta: Na mesma tela do Provedor API, você pegará o campo “Id do usuário”
Nesse caso é o ‘isocrm’.
Observação: (Deixa em branco)
Ordem: 1
Ativo: Marca essa opção
Clica em salvar.
Ficará da seguinte forma:
Feito esses passos o parâmetro estará configurado e ativo, agora precisará adicionar os usuários que deseja que atendam ao whats, dentro da classificação do WhatsApp.
4º Passo: Adicionar os agentes à classificação de WhatsApp:
Para isso siga o seguinte caminho, supervisor -> chat -> classificação -> clica na ‘lupa’ -> aba ‘atendentes’ -> incluir.
Adiciona o agente que quiser que tenha acesso a tela de atendimento do WhatsApp, e se quiser já pode incluir ele como supervisor também ou não:
Clica em ‘inserir’ duas vezes, e estará feito.
Após seguir esse passo a passo o ambiente estará devidamente configurado, e agora é apenas fazer o teste, enviar uma mensagem para o número, e solicitar para o bot direcionar você para um agente e testar:
Tela do Omnichannel:
Basta clicar na conversa e pronto, testado e aprovado.
Parâmetros para configuração e funcionamento do isoBot.
Parâmetro: ISOCHATBOT
Pergunta: CLASS_CHAT_ATENDIMENTO
Resposta: Código da classificação chat utilizada para atendimento humano.
Pergunta: AVISO_CONV_INCIADA
Resposta: 'S' para mensagem simples. 'C' para mensagem completa com o nome do atendente. 'N' Não envia mensagem de início.
Pergunta: AVISO_TRANSFER
Resposta: 'S' para enviar mensagem de transferência de atendente. 'N' não envia mensagem de transferência de atendente.
Pergunta: AVISO_ESPERA
Resposta: 'S' para enviar mensagem que o chat foi colocado "Em espera". 'N' envia não mensagem de espera.
Pergunta: TIPO_TELEFONE
Resposta: Código do tipo do telefone. Para quando vincular um chat em um cadastro.
Pergunta: TIPO_ECONTACT
Resposta: Código do tipo do e-contact. Para quando vincular um chat em um cadastro.
Pergunta: MSG_ENCERRAMENTO
Resposta: Utilizar a observação para a mensagem.
Observação: "Olá cliente, esse atendimento foi finalizado, mas qualquer dúvida, estamos a disposição. Atenciosamente, Central de Atendimento."
Pergunta: TAMANHO_MAX_ANEXO
Resposta: Valor em MB. Ex.: 100
Parâmetros para conexão com o provedor:
Parâmetro: ISOCHATBOT
Pergunta: PROVEDOR_ID
Resposta: Id do usuário.
Pergunta: PROVEDOR_SECRET_ID
Resposta: Id "não identificado".
Pergunta: PROVEDOR_TOKEN
Resposta: 'PROVEDOR TOKEN'
Observação: AcessarToken (Utilizar o campo observação, pois o token excede o tamanho da resposta)
Pergunta: PROVEDOR_REFRESHTOKEN
Resposta: Código da classificação chat utilizada para atendimento humano.
Observação: Atualizar Token (Utilizar o campo observação, pois o refresh token excede o tamanho da resposta)
Pergunta: NomeBot
Resposta: Nome do bot configurado no provedor. (Necessário para integrações dos templates). Ex.: isocrmsandbox
Pergunta: PROVEDOR_PHONE
Resposta: Numero do telefone configurado no provedor. Ex. 5541999999999
Pergunta: linkImage
Resposta: Link de uma imagem para referenciar o cliente. Utilizado para o cadastro de templates. Por padrão utiliza a imagem do sistema (../k2bimages/logoisocrm.png).
Efetuar a atualização do "token" manualmente.
Na tela de configurações do Omnichannel, entrar no menu Supervisor > Chat > Setup chat e clicar na opção "Atualizar token". Com isso as credenciais serão atualizadas. Os detalhes PROVEDOR_ID, PROVEDOR_SECRET_ID e PROVEDOR_REFRESHTOKEN devem estar cadastrados no parâmetro ISOCHATBOT .
Uma vez ao dia é efetuado a verificação da validade do token de forma automática. A data base para a verificação fica gravada no detalhe PROVEDOR_DATE no parâmetro ISOCHATBOT.
Status da mensagem
A atualização dos status das mensagens somente ocorre em algumas situações e conforme o canal de comunicação.
WhatsApp:
Mensagem enviada - Informa que a mensagem foi enviada com sucesso;
Mensagem entregue - Informa que a mensagem foi entregue ao destinatário com sucesso;
Mensagem lida - Informa que a mensagem foi lida pelo destinatário com sucesso;
Falha do envio - Informa que teve uma falha no envio; A falha pode se dar por problema de autenticação com o provedor, falha de acesso ao serviço ou template não suportado.
Facebook Messenger / Instagram Chat / Telegram
Mensagem enviada - Informa que a mensagem foi enviada com sucesso;
Falha do envio - Informa que teve uma falha no envio; A falha pode se dar por problema de autenticação com o provedor ou falha de acesso ao serviço.