Este artigo explica as etapas necessárias para conectar a Botmaker ao Zendesk por meio da nova integração nativa.

Leitura estimada: 5 minutos

Agora temos uma nova integração nativa para conectar o Zendesk a Botmaker. É importante esclarecer que a conexão/integração deverá ser feita/configurada a partir da plataforma Zendesk. Ou seja, para realizar a integração devemos ter uma conta Zendesk ativa e estar logado nessa plataforma.

1. Instalando o aplicativo “Botmaker Chat” no Zendesk.

Uma vez logado no Zendesk, entraremos no “Centro de Administração”. Você pode fazer isso usando o seguinte link/url, basta substituir “botmakertest” pelo nome da sua conta,https://botmakertest.zendesk.com/admin/home , você verá uma tela semelhante a esta abaixo:

A partir daí, o próximo passo é entrar no botão “Aplicativos e integrações” localizado no canto inferior direito da sua tela. Além disso, você pode fazer isso usando o seguinte link/url, basta substituir “botmakertest” pelo nome da sua conta,https://botmakertest.zendesk.com/admin/apps-integrations/apps/support-apps . Você deverá ver uma tela como esta:

Uma vez localizado na tela “meus aplicativos”, selecionaremos o botão que diz “Carregar aplicativo privado” e dentro da caixa de texto “nome do aplicativo” escreveremos Bate-papo do criador de bots , respeitando letras maiúsculas, minúsculas e espaços, então ao fazer o upload do arquivo ZIP com o pacote que vamos instalar, você deverá ver esta tela:

Ao clicar em carregar exibiremos uma tela de aviso, isso porque o pacote está em processo de aprovação, então poderemos selecioná-lo diretamente do Marketplace, então clicaremos em “carregar” novamente.

Usar: O arquivo “2250932.zip” será compartilhado durante o Meet ou conversa de integração.

Assim que o aplicativo for carregado, veremos esta tela:

e no final um botão de instalação conforme mostrado abaixo:

Ao final da instalação poderemos verificar que na tela Aplicativos e integrações / Aplicativos do Zendesk Support existe o “Botmaker Chat” como pode ser visto abaixo:

2. Configurando credenciais para usar o “Botmaker Chat” no Zendesk.

Agora é hora de começar a configurar as credenciais do nosso aplicativo. Para isso, a primeira coisa que devemos fazer é entrar na seção “Aplicativos e integrações/ API Zendesk/ Clientes OAuth” e lá pressionaremos o botão “Adicionar cliente OAuth” como pode ser visto na tela abaixo:

Uma vez lá, vamos preencher os campos com as informações que podem ser vistas a seguir:

• Nome do cliente: Integração Botmaker,
• Descrição: Acesso ao aplicativo Botmaker Chat no Zendesk,
• Identificador único: botmaker_integration, 
• URL de redirecionamento: (domínio da organização).zendesk.com

A seguir vamos gerar o segredo e veremos uma tela como a seguinte:

Depois de salvar as alterações, você verá a tela com parte do “segredo” oculta. Isso parecerá assim:

3.Verificando la instalación e iniciando sesión en  Botmaker desde Zendesk.

Agora vamos testar se está tudo correto, para isso iremos para a página principal do nosso zendesk, lá poderemos ver o ícone do nosso aplicativo Botmaker Chat, que está localizado no lado esquerdo, quando ao pressioná-lo veremos uma mensagem informando que a instalação está sendo verificada conforme mostra a imagem abaixo:

Aquela mensagem “Verificando a instalação do Zendesk…” deve durar apenas alguns segundos, caso não vá para a próxima tela você deve verificar se ao instalar o aplicativo você respeitou o seu nome “Botmaker Chat” (passo 1) e que ao criar o OAuth credenciais, o nome do cliente é “Botmaker Integration” (etapa 2).

Se tudo correr bem você verá a tela de boas-vindas conforme abaixo:

Agora você só precisa fazer login no Botmaker.

Para ter em conta!!:

• Os e-mails dos agentes devem ser idênticos em ambas as plataformas, Botmaker e Zendesk. No botmaker você deve configurar a função do agente como agente, assim o Zendesk terá a visão correta.
• Os e-mails dos agentes criados a partir da integração, ou seja, do Zendesk, só podem efetuar login no Botmaker através da integração, ou seja, do Zendesk através do app Botmaker Chat.
• Os tickets são criados com base na configuração do bot. Ao configurar o fluxo no Botmaker você deve utilizar as ações de “Criar objeto CRM externo”, “Habilite a integração de CRM" e "Desabilitar integração com CRM” . Além disso, eles estão disponíveis “Pesquisar objeto CRM externo" e "Atualizar objeto CRM externo”.
• De acordo com a experiência/fluxo conversacional desejado pelo cliente, o bot pode ser silenciado quando o ticket for criado e reativado quando o ticket for fechado.
• Se precisar criar um novo ticket você terá que deletar a variável ${currentTicket}.
• Somente eventos padronizados são exibidos.

Na imagem abaixo você pode ver a visualização do ticket/conversa de um agente do Zendesk:

Integração Zendesk para gerar tickets de conversa no WhatsApp

Assim que sua linha WhatsApp estiver ativa, você deverá entrar em contato com nossa equipe de suporte para finalizar a integração. Lembre-se que esta integração sempre exigirá uma conta Zendesk ativa.

Siga as próximas etapas:

Passo 1: Envie o subdomínio Zendesk para nossa equipe de suporte. Ele será integrado ao seu bot.

Passo 2: Após confirmar a adição do domínio, faça login no Zendesk em "Configurações> Integrações de canais" e atualize a página para vincular a integração.

Etapa 3: Após adicionar com sucesso o aplicativo Botmaker ao Zendesk, entre em contato com nossa equipe de suporte para que eles possam ativar a integração ao sistema.

Pronto! Sua integração com o Zendesk agora estará pronta para uso, transformando suas conversas do WhatsApp em tickets em tempo real.

Escrito por: Time Botmaker

Atualizado: 09/02/2024