Mensagens Ativas do WhatsApp no Blip Desk: Retorno para um bloco do Fluxo do Bot 5 de janeiro de 2024 17:13 Atualizado Índice: Como direcionar o retorno da mensagem ativa? Retorno para um bloco do Fluxo do Bot conforme o status do atendente Como direcionar o retorno da mensagem ativa? É possível direcionar o retorno da mensagem ativa para qualquer bloco do fluxo do bot, seja ele novo ou existente, fazendo com o cliente percorra o fluxo do bot ou parte dele após o disparo individual realizado dentro do Blip Desk. Nesse caso, é importante observar que, dependendo da ação do usuário, caso haja um transbordo, esta ação sempre irá considerar as regras definidas em “Regras de atendimento”. Primeiramente, é necessário configurar o Fluxo de Retorno através do portal. Acesse a página “Atendimento” do seu chatbot. No menu lateral, clique em “Modelos de Mensagens”. Em seguida, escolha o template que deseja configurar e clique no lápis à direita da tela. Selecione um bloco do fluxo do bot para onde o retorno do cliente será direcionado. Não é possível optar por mais de um Fluxo de Retorno para o mesmo template. Importante! Embora seja possível direcionar o retorno da mensagem ativa para um bloco existente no fluxo do bot, sugerimos criar um novo bloco para tratar das customizações relacionadas às mensagens ativas, descritas abaixo. Ao direcionar o retorno do cliente para um bloco do fluxo do bot que não seja o bloco de atendimento humano, o cliente será considerado um contato do bot, ou seja, não será mais um contato iniciado por Mensagem Ativa no Blip Desk. Pensando no gerenciamento e criação de relatórios, caso seja necessário o rastreamento deste retorno como um contato derivado de uma Mensagem Ativa, é necessário realizar a seguinte configuração: 1. Clique em “+Adicionar ação de saída”. 2. Será aberto um menu. Escolha a opção “Definir variável”. 3. No campo “Nome da variável”, adicione o texto: campaignId 4. No campo “Valor”, adicione o texto: {{contact.extras.campaignId}} 5. Não é necessário preencher o campo “Expiração (opcional)” 6. Clique na flecha ao lado de “Definir variáveis” para voltar a visão inicial. Retorno para um bloco do Fluxo do Bot conforme o status do atendente Além do direcionamento do retorno da mensagem ativa para qualquer bloco do fluxo do bot, é possível configurar diferentes ações conforme o status do atendente. Para isso, acesse a página do “Builder” e clique sobre o bloco selecionado como Fluxo de Retorno (o mesmo bloco definido no passo anterior). À direita da tela, clique na aba Ações. Em seguida, serão necessárias algumas customizações, são elas: Etapa 1 - Recuperando o ID da Campanha: 1. Em Ações de entrada, clique em +Adicionar ação de entrada. 2. Será aberto um menu. Escolha a opção Definir variável. 3. No campo Nome da variável, adicione o texto: campaignId 4. No campo Valor, adicione o texto: {{contact.extras.campaignId}} 5. No campo Expiração (opcional)*, adicione o número: 60 6. Clique na flecha ao lado de Definir variáveis para voltar a visão inicial. Importante: O preenchimento deste campo é opcional, mas sugerimos o preenchimento conforme indicado acima para que a variável de contexto não se torne infinita. Etapa 2 - Recuperar a campanha pelo ID da campanha: 7. Clique novamente em +Adicionar ação de entrada. 8. No menu que será aberto, clique em Processar comando. 9. No campo Para, adicione o texto: postmaster@activecampaign.msging.net 10. No campo Método, selecione a opção: get 11. No campo URI, adicione o texto: /campaigns/{{context.campaignId}} 12. Em Salvar resposta, no campo Variável da resposta, adicione o texto: campaign 13. Clique na flecha ao lado de Processar comando para voltar a visão inicial. Etapa 3 - Extrair o atendente que gerou o disparo: 14. Clique novamente em +Adicionar ação de entrada. 15. Será aberto um menu. Clique em Executar script. 16. Clique em Variáveis de entrada e adicione a variável: campaign 17. Em seguida, clique em Script e na tela à esquerda, cole o texto abaixo: function run(campaign) { var response = JSON.parse(campaign); var campaignExists = (response && response.resource) if (campaignExists) { var identity = response.resource.campaignSender; return (identity !== undefined) ? encodeURIComponent(identity) : identity; }} 18. À direita da tela, em Salvar retorno, no campo Variável para o valor de retorno, adicione o texto: encodedAttendanceRedirect 19. Clique na flecha ao lado de Executar script para voltar a visão inicial. Etapa 4 - Obter o status do atendente que fez o disparo: 20. Em Ações de saída, clique em +Adicionar ação de saída. 21. No menu que será aberto, clique em Processar comando. 22. No campo Para, adicione o texto: postmaster@desk.msging.net 23. No campo Método, selecione a opção: get 24. No campo URI, adicione o texto: /agents/status?ownerIdentity={{context.encodedAttendanceRedirect}} 25. Em Salvar Resposta, no campo Variável da resposta, adicione o texto: agentStatus 26. Em seguida, em Condição para processar comando, clique em +Adicionar condição de processamento. 27. No campo Se, selecione a opção: Variável 28. No campo Condição, selecione a opção: Existe 29. No campo Nome da variável, selecione a opção: encodedAttendanceRedirect 30. Clique na flecha ao lado de Processar comando para voltar a visão inicial. Etapa 5 - Setar o status do atendente para uma variável: 31. Clique novamente em +Adicionar ação de saída. 32. Será aberto um menu. Clique em Executar script. 33. Clique em Variáveis de entrada e adicione a variável: agentStatus 34. Em seguida, clique em Script e na tela à esquerda, cole o texto abaixo: function run(agentStatus) { var response = JSON.parse(agentStatus); var statusExists = (response && response.resource) if (statusExists) { return response.resource.status; }} 35. À direita da tela, em Salvar retorno, no campo Variável para o valor de retorno, adicione o texto: status 36. Em seguida, em Condição para executar script, clique em +Adicionar condição de execução. 37. No campo Se, selecione a opção: Variável 38. No campo Condição, selecione a opção: Existe 39. No campo Nome da variável, selecione a opção: agentStatus 40. Clique na flecha ao lado de Executar script para voltar a visão inicial. Etapa 6 - Setar atendente para transbordo direto se estiver online: 41. Clique novamente em +Adicionar ação de saída. 42. Será aberto um menu. Escolha a opção Definir variável. 43. No campo Nome da variável, adicione o texto: attendanceRedirect 44. No campo Valor, adicione o texto: {{context.campaignSender}} 45. No campo Expiração (opcional)*, adicione o número: 60 46. Em seguida, em Condição para definir variável, clique em +Adicionar condição de definição. 47. No campo Se, selecione a opção: Variável 48. No campo Condição, selecione a opção: Igual a 49. No campo Nome da variável, adicione o texto: status 50. No campo Valor, adicione o texto: online 51. Clique na flecha ao lado de Definir variáveis para voltar a visão inicial. Importante: O preenchimento deste campo é opcional, mas sugerimos o preenchimento conforme indicado acima para que a variável de contexto não se torne infinita. Etapa 7 - Setar fila específica no transbordo se o atendente não estiver online: 52. Clique novamente em +Adicionar ação de saída. 53. Será aberto um menu. Escolha a opção Definir variável. 54. No campo Nome da variável, adicione o texto: attendanceQueueToRedirect 55. No campo Valor, adicione o nome da fila para onde o ticket será transbordado 56. No campo Expiração (opcional)*, adicione o número: 60 57. Em seguida, em Condição para definir variável, clique em +Adicionar condição de definição. 58. No campo Se, selecione a opção: Variável 59. No campo Condição, selecione a opção: Diferente de 60. No campo Nome da variável, adicione o texto: status 61. No campo Valor, adicione o texto: online 62. Clique na flecha ao lado de Definir variáveis para voltar a visão inicial. Importante: O preenchimento deste campo é opcional, mas sugerimos o preenchimento conforme indicado acima para que a variável de contexto não se torne infinita. Etapa 8 - Setar o ID da campanha no ticket: Importante! Ao direcionar o retorno do cliente para um bloco do fluxo do bot que não seja o bloco de atendimento humano, o cliente será considerado um contato do bot, ou seja, não será mais um contato iniciado por Mensagem Ativa no Blip Desk. Pensando no gerenciamento e criação de relatórios, caso seja necessário o rastreamento deste retorno como um contato derivado de uma Mensagem Ativa, é necessário realizar esta etapa. 63. Clique novamente em +Adicionar ação de saída. 64. Será aberto um menu. Escolha a opção Definir variável. 65. No campo Nome da variável, adicione o texto: campaignId 66. No campo Valor, adicione o texto: {{contact.extras.campaignId}} 67. No campo Expiração (opcional)*, adicione o número: 60 68. Clique na flecha ao lado de Definir variáveis para voltar a visão inicial. Importante: O preenchimento deste campo é opcional, mas sugerimos o preenchimento conforme indicado acima para que a variável de contexto não se torne infinita. Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Envio de Mensagens Ativas do WhatsApp no Blip Desk Como enviar notificações WhatsApp via API do Blip Como configurar o direcionamento de resposta de uma mensagem ativa, para um atendente no Blip Desk(Beta) Mensagens Ativas - Códigos de erro Como enviar notificações WhatsApp via API Active Campaign (Growth)