⭐ Resumo
Planos mais básicos do Zendesk não liberam a integração nativa de conversas. Para contornar isso, utilizamos uma tela do Cloud Blocks, que realiza a requisição necessária para criar a integração manualmente.
Passo a passo da integração
📸 https://www.loom.com/share/7005b2416480499ca639e5a02f8270be
1️⃣ Acessar o projeto no Cloud Hub
-
Entre no Hub
-
Acesse o projeto desejado
-
No menu lateral, clique em Integrações
-
Selecione Zendesk
-
Escolha a opção Chat
2️⃣ Preencher dados básicos do Zendesk
-
Subdomínio: Copie o trecho antes de
.zendesk.comda URL do Zendesk
Exemplo:https://empresa.zendesk.com→empresa -
Usuário: Utilize o login da conta que será usada pela ClaudIA:
-
Pode ser uma conta dedicada
-
Ou a conta de um agente específico, de preferência, sem uso frequente
-
Mas com plano pago ativo

-
3️⃣ Criar Token de API no Zendesk
-
Acesse Central de Administração
-
Vá em API → Tokens
-
Clique em Adicionar novo token
-
Nomeie o token (exemplo:
Cloud Humans | Connector) -
Salve e copie o token gerado
-
Cole o token no campo correspondente no Hub
4️⃣ Criar grupos no Zendesk
Crie os grupos antes de avançar na integração.
Grupo da ClaudIA
-
Nome sugerido: Cloud Humans
-
Adicione a conta da ClaudIA ao grupo
-
Copie o ID do grupo pela URL
-
Cole no campo ID do Grupo da ClaudIA no Hub
Grupo de Transbordo (N2)
-
Nome sugerido: N2
-
Inclua os agentes de atendimento humano
-
Copie o ID do grupo
-
Cole no campo ID do Grupo N2
💡 Se o campo do grupo da ClaudIA ficar vazio, o sistema cria um grupo automaticamente. A recomendação é criar manualmente para maior controle.
5️⃣ Tela alternativa de integração (Cloud Blocks)
Como o plano não exibe a aba de integrações:
-
Acesse a tela de integração do Cloud Blocks: https://cloudblocks.cloudhumans.com/apps/69600827212693490b882c6f/view
-
Preencha:
-
Project name: exatamente igual ao nome do projeto.
-
Subdomínio: mesmo subdomínio do Zendesk.
-
6️⃣ Captura de Cookie e CSRF Token
-
No Zendesk, pressione F12.
-
Recarregue a página.
-
Na aba Network, procure por
session.json. -
Em Request Headers:
-
Copie todo o valor de Cookie.
-
Copie o valor de X-CSRF-Token.
-
-
Cole essas informações nos respectivos campos da tela do Cloud Blocks.
💡Importante: Em caso de dúvida, visualize o vídeo explicando todos os detalhes.
7️⃣ Gerar credenciais
-
Execute a ação (Run).
-
Serão gerados:
-
ID do aplicativo
-
ID da chave
-
Secret Key
-
-
Copie e salve todas.
8️⃣Finalização
-
Salve a integração.
-
A integração será criada corretamente.
❗Observação final
-
Em planos avançados do Zendesk, esse processo pode ser feito diretamente pela interface.
Passo a passo descrito na FAQ: https://cloudchat.cloudhumans.com/hc/claudia/articles/1767905297-zendesk-integracao-de-chat-e-whats_app -
Em planos básicos, essa tela intermediária é obrigatória.