Este guia descreve como configurar um respondente padrão por canal por meio de uma chamada da API no Sunshine Conversations.
Observação: este guia usa o Postman. Se você não tiver o Postman, crie uma conta no site do Postman e baixe o aplicativo.
Importar o modelo da API
- Abra o arquivo postman_collection.json. A coleção está no formato JSON e não é muito fácil de ler.
- Selecione todo o texto e copie-o.
3. Abra o Postman e clique em Importar.
4. Cole o conteúdo do arquivo da coleção na caixa de texto "Colar cURL, texto bruto ou URL".
A coleção da API do Sunshine Conversations é exibida na interface do Postman.
Selecionar a chamada da API PATCH na lista Coleções
- No Postman, na coleção de APIs do Sunshine Conversations, selecione Integração > Atualizar integração.
- Siga as etapas em Obter uma lista de IDs de integração das mensagens para recuperar uma lista completa de seus IDs de integração e o ID do respondente padrão para agentes de IA.
O ID do respondente padrão é o mesmo para todas as integrações.
- Para a chamada da API PATCH, substitua o ponto de extremidade padrão pelo ID do aplicativo da chave da API do Zendesk (a mesma usada para se conectar ao Agentes de IA - Avançado) e o ID da integração que você deseja modificar. Neste exemplo, focaremos a integração com iOS para que ela possa ser lançada na web sem o SDK do aplicativo.
- Como mostrado acima, clique na aba Autenticação e selecione Autenticação básica. Insira o ID da chave e a chave secreta, ambos provenientes das mesmas informações da API do Zendesk.
- Na aba Corpo, defina manualmente a integração (iOS) para usar os agentes de IA usando o ID do respondente padrão dos agentes de IA (mesmo que ela já esteja definida).
Remova todo o conteúdo no corpo, exceto "defaultResponderId", e adicione o ID obtido da chamada da API da lista de integração. Lembre-se de remover vírgulas irrelevantes.
- Execute a chamada da API PATCH e a chamada da API GET da lista de integração para verificar a atualização teve êxito.
Após fazer a alteração, o canal do iOS continua a usar agentes de IA. No entanto, o campo "herdado" agora está definido como falso, o que indica que ele não mudará automaticamente para o Agentes de IA - Avançado quando este estiver conectado.
- Conecte o Agentes de IA - Avançado ao ambiente de produção do ZD. Observe que apenas os canais marcados com "herdado = verdadeiro" o usarão.
- Quando o cliente decidir fazer a transição de canais adicionais para o Agentes de IA - Avançado, envie o valor "null" (sem aspas) para o ID da integração do canal desejado. Essa ação reverte o canal para seu comportamento padrão, alternando entre o Agentes de IA - Avançado e o Zendesk, dependendo do status de conexão do Agentes de IA - Avançado.
A lista agora mostra que o canal do iOS foi revertido para o uso do Agentes de IA - Avançado.
Agora, sempre que você desconectar o Agentes de IA - Avançado, todos os canais marcados com um status herdado serão revertidos para o agente de IA e vice-versa. Quaisquer canais que foram definidos manualmente para o agente de IA permanecerão no agente de IA independentemente.
Advertência: evite definir manualmente um canal ao Agentes de IA - Avançado com a propriedade herdada definida como falsa. Isso pode impedir a desconexão do Agentes de IA - Avançado do Zendesk. Se houver problemas com o Agentes de IA - Avançado, o respondente padrão permanecerá no Agentes de IA - Avançado, podendo fazer com que os chats fiquem sem resposta.