Mensagens Ativas do WhatsApp no Blip Desk: Retorno para um bloco do Fluxo do Bot 25 de novembro de 2024 12:57 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 - Extrair o atendente que gerou o disparo: 41. Clique novamente em +Adicionar ação de entrada. 42. Será aberto um menu. Clique em Executar script. 43. Clique em Variáveis de entrada e adicione a variável: campaign 44. 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 ? identity : undefined; }} 45. À direita da tela, em Salvar retorno, no campo Variável para o valor de retorno, adicione o texto: campaignSender 46. Clique na flecha ao lado de Executar script para voltar a visão inicial. 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 configurar o direcionamento de resposta de uma mensagem ativa, para um atendente no Blip Desk(Beta) Como enviar notificações WhatsApp via API do Blip Como enviar notificações via API Active Campaign (Growth) Mensagens Ativas - Códigos de erro