No painel Agentes de IA, não é possível criar modelos se você integra seu bot com o recurso de mensagens e não diretamente com Sunshine Conversations.
Esta receita explica como criar o modelo por meio da Sunshine Conversations (SunCo) API e, em seguida, aplicar o atalho em um fluxo de diálogo.
O fluxo de trabalho inclui as etapas abaixo:
- Etapa 1: Crie as chaves da API necessárias
- Etapa 2: Use as chaves da API e a API SunCo para criar um modelo
- Etapa 3: Aplicar a abreviação Sunshine Conversations em um fluxo de diálogo
Etapa 1: Criar as chaves de API obrigatórias
Para criar as chaves da API de conversas, siga as instruções deste artigo: Uso de chaves da API de conversas.
Etapa 2: Use as chaves da API e a API SunCo para criar um modelo
Você precisará de uma ferramenta como o Postman para fazer chamadas para a API SunCo.
Configurar o Postman com a API SunCo
- Baixe o aplicativo Postman do website: Postman Downloads
- Para baixar a coleção Postman da SunCo, clique com o botão direito do mouse no arquivo e salve-o em sua unidade local. Ver Arquivo de coleção Postman
- No Postman, para importar o arquivo de coleção, selecione Importar no canto superior direito. Isso importará a coleção e a nomeará Smooch
Autorize o Postman com suas chaves da API de conversas
- Clique na coleção recém-criada chamada Smooch e selecione a aba Variáveis
- Adicione três novas variáveis:
keyId
,appId
esecret
- Na coluna Valor atual, adicione os valores que correspondem e que foram obtidos da Central de administração
- Clique em Salvar no canto superior direito
- Selecione a aba Autorização
- Clique no menu suspenso Tipo de autenticação e selecione Auth básica.
- No campo Nome de usuário, adicione a variável
{{keyId}}
. Isso fará referência ao valor keyId configurado na aba Variáveis - No campo Senha, adicione a variável
{{secret}}
- Clique em Salvar no canto superior direito
Criar um modelo
Siga estas etapas sobre como criar modelos, que incluem os diferentes tipos de modelos. O ponto de extremidade usado para criar novos modelos é o ponto de extremidade Criar modelos. Você pode ver a documentação da API para esse ponto de extremidade aqui.
- No Postman, abra a pasta Modelos > Criar exemplos de modelo. Os pontos de extremidade de exemplo para criar modelos ficam aqui
- Selecione um ponto de extremidade de exemplo e preencha o corpo da resposta. Você também pode criar seu próprio ponto de extremidade e começar do zero
- Clique no botão Enviar no canto superior direito para enviar a solicitação e criar o modelo. A resposta retornará um campo de
name
, certifique-se de copiar isso, pois será necessário na próxima etapa
Etapa 3: Aplicar a abreviação Sunshine Conversations em um fluxo de diálogo
Os modelos podem ser enviados usando a sintaxe abreviada dedicada. Para garantir que o agente de IA envie o modelo, o atalho deve ser adicionado a um bloco de mensagens do agente de IA no criador de diálogos.
- No painel Agentes de IA Advanced, abra a caixa de diálogo de onde deseja que o modelo seja enviado
- Adicionar um bloco de mensagens do agente de IA ao fluxo de diálogo
- No bloco recém-criado, adicione o modelo com a sintaxe abreviada:
%((template:value_of_name_field))%
- Publicar o diálogo
O bot enviará o modelo no meio do fluxo de conversa. Você precisará fazer as alterações no modelo pela API.
Aviso sobre a tradução: este artigo foi traduzido por um software de tradução automática para oferecer a você uma compreensão básica do conteúdo. Medidas razoáveis foram tomadas para fornecer uma tradução precisa, no entanto, a Zendesk não garante a precisão da tradução.
Em caso de dúvidas relacionadas à precisão das informações contidas no artigo traduzido, consulte a versão oficial do artigo em inglês.