Requisitos
- Acesso de administrador ao agente de IA no painel do Agentes de IA - Avançado
- Assinatura do Zendesk
- Espaço de trabalho do agente do Zendesk
- Uma licença do Sunshine Conversations
Etapa 1: criar uma chave de API
Na Central de administração do Zendesk, acesse Aplicativos e integrações > APIs > API de conversas
Se isso não aparecer, entre em contato com a Zendesk para adicioná-lo à sua configuração. Se você tiver acesso ao painel do Smooch, siga as instruções aqui.
- Crie uma nova chave de API para o agente de IA.
- Dê um nome à sua chave de API.
- Uma página será exibida com uma cópia do ID do aplicativo, do ID da chave e do segredo. Salve todas essas informações.
Etapa 2: configurar parâmetros de integração de grupo no painel do Agentes de IA - Avançado
Você precisará adicionar o Sunshine Conversations como a integração de CRM antes de configurar os parâmetros de integração para autorização.
Observação: adicionamos o encaminhamento para o Grupo do Sunshine. É um novo recurso que permite o encaminhamento para diferentes agentes de IA em nosso painel, a fim de acomodar diferentes consultas de clientes em diferentes canais.
Portanto, recomendamos usá-lo para todos os nossos clientes que utilizam o Zendesk Messaging e o Sunshine Conversations, mesmo que você tenha apenas um agente de IA no momento.
Como adicionar o Sunshine Conversations como a integração de CRM:- Acesse Configurações > Integração de CRM
- Clique em Adicionar integração de CRM
- Selecione Grupo do Sunshine > Criar grupo
- Para o campo Transferir grupo, insira o ID do grupo de agentes no Zendesk. Clique aqui para descobrir como localizar o ID do grupo.
- A URL do avatar é uma imagem que pode ser usada como imagem de perfil para o seu avatar dentro da área de chat. A API do Sunshine Conversations por trás do recurso é o ponto de extremidade postMessage. Conforme declarado pela documentação, o campo de URL do avatar deve estar no formato JPG, PNG ou GIF.Observação: isso está visível apenas no Sunshine Conversations no momento e não é exibido no Zendesk.
Para configurar os parâmetros de integração de grupos:
- Acesse Configurações > Integração de CRM.
- Clique em Parâmetros de integração de grupo. Uma nova página será aberta.
- Obtenha as informações nesta página do aplicativo criado na Etapa 1 no Sunshine Conversations. As informações aqui são necessárias para autorizar a conexão entre o Agentes de IA - Avançado e o Sunshine.
Para obter os parâmetros de integração de grupo do Sunshine Conversations:
-
Clique no aplicativo criado na Etapa 1 e acesse Configurações.
-
Copie os seguintes parâmetros do aplicativo para inserir no painel do Agentes de IA - Avançado:
- App ID
-
ID da chave
-
Chave secreta
-
Observação: clique em Criar nova chave de API se nenhuma aparecer.
-
- Clique em Salvar.
Etapa 3: autorizar a conexão entre o Agentes de IA - Avançado e o Sunshine
Essa etapa só é necessária se você usa o Sunshine Conversations com o Zendesk. Se você usa outras plataformas além do Zendesk, ignore esta etapa e entre em contato conosco.
- Não altere o painel do Agentes de IA - Avançado.
- Abra e entre no Sunshine Conversations em uma aba diferente.
-
No painel do Agentes de IA - Avançado, em Autorização, clique em Autorizar o Sunshine Conversations.
-
Uma nova página será aberta.
-
Se solicitado, insira seu subdomínio do Zendesk e entre com sua conta do Zendesk.
-
Se estiver autorizando pelo painel do Smooch, selecione o aplicativo criado na Etapa 1.
-
-
Isso estará concluído quando o botão no painel do Agentes de IA - Avançado for alterado para Desautorizar o Sunshine Conversations.
-
Isso só precisa ser feito uma vez se você tiver mais de um agente de IA.
Etapa 4: testar seu agente de IA
Hora de abrir seu widget do Sunshine, conversar com o agente de IA e verificar se tudo está funcionando bem.
Não tem certeza de onde está o widget? Esta é a documentação do Sunshine sobre como adicioná-lo à sua página da web. Sugerimos que você fale com o desenvolvedor ou gerente do seu site e compartilhe o documento com eles.
Se você tiver outros canais, como WhatsApp, Facebook Messenger ou Instagram, consulte a documentação do Sunshine Conversations sobre como fazer a integração com diferentes canais. Lá, você pode obter detalhes sobre cada um dos canais no menu lateral.
Observação: se você quiser personalizar a imagem do avatar do agente de IA, forneça uma imagem que atenda aos requisitos a seguir para o seu CSM. Depois, poderemos configurar isso para você.
- png, jpg ou gif
- Tamanho mínimo de 128 x 128
- Dimensões iguais de altura e largura (ou o Sunshine Conversations ampliará para o tamanho necessário)
PERGUNTAS FREQUENTES
Como editar os parâmetros de integração após a configuração
É possível que, ao tentar editar uma integração ativada, você não consiga salvar as alterações. Esse é um recurso de segurança para garantir que as integrações em tempo real não sejam alteradas acidentalmente.
No entanto, é possível fazer alterações, mas primeiro você precisa desativar a opção de automação.
Depois que isso for desativado, o botão de não autorizado do Sunshine Conversations poderá ser clicado e, então, desativado. Aqui, é possível fazer edições e repetir o processo descrito acima.
Conexão pelo painel do Smooch
Etapa 1: criar um novo aplicativo no Sunshine Conversations
Entre no Sunshine Conversations em https://app.smooch.io/login e crie um novo aplicativo.
- Se você já tem um aplicativo no Sunshine Conversations conectado à sua instância do Zendesk, prossiga para a Etapa 4.
- Se você usa o Zendesk, mas ainda não tem um aplicativo no Sunshine Conversations, prossiga para a Etapa 2.
- Se você usa outras plataformas além do Zendesk, ignore a Etapa 4 ou entre em contato conosco.
Etapa 2: conectar o aplicativo do Sunshine à sua instância do Zendesk
Essa etapa é crucial para que o Agentes de IA - Avançado funcione e só pode ser realizada pelo Sunshine Conversations ou pelo Zendesk.
Peça ao seu gerente de conta no Sunshine Conversations ou Zendesk para adicionar sua conta do Zendesk ao aplicativo criado na Etapa 1 no Sunshine Conversations. Se isso for concluído, você verá o Zendesk listado como uma integração conectada depois de clicar no aplicativo no Sunshine Conversations.
Após essas etapas, continue a partir da Etapa 3, conforme mencionado acima.