Zendesk

Neste guia, veremos como integrar seu Assistente de IA ao Zendesk. Resumo:

1. Configurar uma conta Zendesk
2. Ativar respostas do Quickchat AI no Zendesk
3. Integrar seu bot do Slack ao Quickchat AI

Dica

Pré‑requisito: sua conta Zendesk deve ser do plano Professional ou superior.

Configuração da conta Zendesk

No Zendesk Admin Center, vá em Apps and integrations → API → Conversations API. Crie uma API key e nomeie (ex.: quickchat-ai-api-key). Anote Zendesk App ID, API Key ID e API Key Secret.

Integrar o Zendesk no Quickchat

No painel do Quickchat, vá em External Apps e clique em Zendesk. Na janela, cole Zendesk App ID, API Key ID e API Key Secret e clique em Conectar com Zendesk. Você verá a mensagem “Sua conta Quickchat está conectada ao Zendesk.” e mais configurações.

Ativar respostas do Quickchat AI no Zendesk

Duas formas:

1: Responder sempre a todas as conversas novas

No Quickchat AI:

1. External Apps → Zendesk
2. Ative “Responder a todas as novas conversas por padrão”
3. Ative “Ativar integração”

Pronto! 🎉 O Assistente responderá por padrão a TODAS as conversas novas.

2: (Avançado) Responder apenas em casos específicos

Transfira para o Quickchat AI somente sob certas condições usando o Zendesk Answer Bot:

No Quickchat:

1. External Apps → Zendesk
2. Desative “Responder a todas as novas conversas por padrão”
3. Copie seu Quickchat Tag (ex.: quickchatai-bot-asd3f23pk1)
4. Ative “Ativar integração”

No Zendesk:

1. Admin Center → Channels → Bots and automation > Bots
2. Clique em Create bot e nomeie
3. Crie uma resposta nova ou edite uma existente
4. No Flow Builder, adicione Transfer to agent
5. Defina a mensagem do bot antes da transferência
6. Adicione seu Quickchat Tag na seção Tags
7. Salve e publique

Quando o Answer Bot atingir a etapa de Transfer e seu Tag estiver presente, a conversa será transferida ao Quickchat AI.

Usar o Human Handoff automático

Ative o botão “Handoff humano automático” dentro da janela da integração do Zendesk. Esse botão só fica disponível quando “Ativar integração” está ligado. Você pode ver um guia geral sobre Human Handoff aqui. Após ativar, o Quickchat AI adicionará o tag “quickchatai-handoff” quando for preciso encaminhar a um humano. Crie um trigger no Zendesk com base nesse tag para notificar/atribuir. Saiba mais: https://support.zendesk.com/hc/en-us/articles/4408822236058-About-triggers-and-how-they-work

Parabéns! 🎉 A integração Zendesk está pronta.