Leitura de 8 minutos Atualizada: 14/01/2026 Criado pela: Equipe Botmaker

Como integrar o Zendesk ao Botmaker?

Com a conexão entre Zendesk e a Botmaker, você pode conectar ambas as plataformas com acesso a uma linha API do WhatsApp. Conheça todos os detalhes desta integração neste artigo.



Contamos com uma nova integração nativa para conectar a Zendesk com a Botmaker. Para fazer isso, você precisará:

  • Da Botmaker, conectar a Zendesk para poder obter e conceder permissões.
  • A conexão/integração também deve ser realizada a partir da plataforma da Zendesk. Ou seja, para realizar a integração, devemos ter uma conta ativa na Zendesk e ter acessado essa plataforma.



Conectar a Zendesk na Botmaker

Para esta conexão, você deve ir em “Canais e integrações” > “Plataformas de CRMs” > “Zendesk”https://go.botmaker.com/#/integrations/crms/zendesk Aparecerá a seguinte tela:


Inserimos o Subdomínio da Zendesk para poder realizar a sincronização. Assim que o botão "Criar Conexão" for pressionado, aparecerá a seguinte tela:



Habilite a permissão que dá acesso e concede permissões à Botmaker para poder realizar a conexão, clicando no botão “Allow”.




Conectar “Botmaker Chat” no app da Zendesk

Assim que iniciar a sessão na Zendesk, vá ao “Central de administração”, que se encontra no menu à direita, nos 4 quadrados ao lado da foto do perfil. Você pode fazer isso usando o seguinte link/url, apenas substituindo “subdomain” pelo nome da sua conta: https://{subdomain}.zendesk.com/admin/home. Você verá uma tela semelhante a esta que está abaixo:



O próximo passo é acessar o botão “Aplicativos e integrações” que se encontra na margem inferior direita da sua tela e clicar em “Aplicativos do Zendesk Support”. Também é possível fazer isso usando o seguinte link/url, apenas substituindo “subdomain” pelo nome da sua conta: https://{subdomain}.zendesk.com/admin/apps-integrations/apps/support-apps. Você deverá ver uma tela como esta:



Uma vez na tela de “Meus Aplicativos”, selecione o botão “Carregar aplicativo privado” e, dentro da caixa de texto “Nome do aplicativo”, escreva textualmente Botmaker Chat, respeitando as maiúsculas, minúsculas e espaços. Em seguida, você deve fazer o upload do arquivo ZIP com o pacote que será instalado para poder finalizar a integração dos sistemas. O arquivo encontra-se em:https://storage.googleapis.com/m-infra.appspot.com/public/botmaker/integrations/zendesk/botmaker_zendesk_chat_v1.4.zip



Ao pressionar carregar, você verá uma tela de aviso; isso ocorre porque o pacote está em processo de homologação. Posteriormente, poderemos selecioná-lo diretamente no Marketplace. Clique em “carregar” novamente.


Uma vez carregado o aplicativo, você verá esta tela:



No final da tela, você verá um botão de instalar, como mostrado abaixo:



Ao finalizar a instalação, você poderá comprovar que na tela de “Aplicativos e integrações/ Aplicativos” do Zendesk Support encontra-se o “Botmaker Chat”, como pode ser visualizado a seguir:



Verificando a instalação e iniciando sessão na Botmaker a partir da Zendesk

Para verificar a conexão correta, vá à página principal da Zendesk. Lá, você poderá visualizar o ícone do app Botmaker Chat, localizado na margem esquerda.



Ao pressioná-lo, veremos uma mensagem indicando que a instalação está sendo verificada, conforme visualizado na imagem abaixo:



A mensagem “Verifying Zendesk installation…” deve durar apenas alguns segundos. Caso contrário, você deve verificar se, ao instalar o app, respeitou o nome do mesmo como “Botmaker Chat” (passo 1) e se, ao criar as credenciais OAuth, o nome do cliente é “Botmaker Integration” (passo 2). Em caso positivo, você verá a tela de boas-vindas como mostrado abaixo:



Agora, basta iniciar a sessão com a conta da Botmaker dentro da Zendesk.



Pontos a serem considerados

  • Os e-mails dos agentes devem ser idênticos em ambas as plataformas, Botmaker e Zendesk. Na Botmaker, deve-se configurar a função do agente como "agente"; dessa forma, na Zendesk, ele terá a visualização correta.
  • Os e-mails de agentes criados a partir da integração, ou seja, pela Zendesk, só podem iniciar sessão na Botmaker por meio da integração (pelo app Botmaker Chat na Zendesk).
  • Os tickets são criados de acordo com a configuração do bot. No momento de configurar o fluxo na Botmaker, você deve usar as ações “Create external CRM object”, “Enable CRM integration” e “Disable CRM integration”. Também estão disponíveis “Search External CRM Object” e “Update External CRM Object”.
  • De acordo com a experiência/fluxo conversacional desejado pelo cliente, é possível silenciar o bot quando o ticket for criado e desativar o silenciamento quando o ticket for fechado.
  • Se precisar criar um novo ticket, você terá que apagar a variável ${currentTicket}.
  • Apenas os eventos padronizados são exibidos.
  • Na imagem abaixo, pode-se visualizar a visão do ticket/conversa de um agente a partir da Zendesk:




Lembre-se de visitar nossa Central de Ajuda para obter mais informações.