Como configurar as etapas Ação de integração e Chamada de ferramenta?

Para que servem?

As duas etapas fazem um trabalho em um sistema externo em um ponto do agente; os visitantes não veem nenhuma delas.

• “Ação de integração” executa uma ação pronta de uma integração conectada (por exemplo, criar um cartão no Trello ou avisar no Slack ou Teams).
• “Chamada de ferramenta” chama uma ferramenta que você definiu para seu próprio sistema na página “Ferramentas” (por exemplo, consultar o status de um pedido).

As duas têm as saídas “Ao concluir” e “Se falhar”, e “Tentar novamente em caso de falha” funciona da mesma forma nas duas.

Ação de integração

Os visitantes não veem esta etapa: o fluxo executa aqui uma ação de uma integração conectada (por exemplo, criar um cartão no Trello ou avisar no Slack ou Teams) e segue em frente.

1. Abra a categoria “Integrações” na paleta “Adicionar etapa”, clique na integração e depois na ação; a etapa é adicionada à tela.
2. No painel da etapa, confira a “Ação” e preencha os campos. Escolha valores de uma lista (“Escolher da lista”) ou digite-os (“Vou digitar”); use {variable} para respostas anteriores.
3. Para usar o resultado nas etapas seguintes, dê a ele um nome de variável em “Salvar em variáveis”. As variáveis ficam no navegador do visitante, então não escolha valores que devam ficar privados.

A etapa tem duas saídas: “Ao concluir” e “Se falhar”. Se a integração não estiver conectada ou o fornecedor retornar um erro, o fluxo segue por “Se falhar”. Se “Se falhar” estiver vazia, a conversa é encerrada com uma mensagem de que algo deu errado. Se você quiser que o agente continue também após uma falha, conecte “Se falhar” à mesma etapa de “Ao concluir”. Se um campo obrigatório estiver vazio, o fornecedor nem é chamado e a etapa segue por “Se falhar”. A “Nota da etapa” é só para você; os visitantes não a veem.

Uma ação que altera dados não é executada de novo quando o visitante pressiona voltar ou reenvia uma mensagem. Se a conversa passar por esta etapa de novo (por exemplo, voltando por um menu), ela é executada novamente.

Enquanto a etapa é executada, o visitante vê o que está acontecendo em vez de “Pensando”: um texto adequado (“Processando seu pedido…”, “Verificando os detalhes…”); para trabalho interno, como avisar sua equipe, apenas “Um momento…”. Você pode escrever seu próprio texto em “Texto mostrado durante a espera” (por exemplo, “Criando seu agendamento…”); ele é traduzido para seus outros idiomas.

Ações que excluem ou cancelam algo permanentemente só são executadas depois que você marca “Entendo que esta etapa faz algo que não pode ser desfeito”; ações que enviam pela sua conta precisam de “Entendo que esta etapa envia pela minha conta”. Exclusões rodam no máximo 20 vezes e envios no máximo 100 vezes por hora em cada espaço de trabalho. O registro a excluir não pode vir de uma resposta do visitante.

Chamada de ferramenta

Chama uma ferramenta definida na página “Ferramentas” exatamente neste ponto do agente, sem usar IA. Os visitantes não veem esta etapa; o texto dela é só sua nota.

1. Adicione uma etapa Chamada de ferramenta e escolha a ferramenta na lista.
2. Dê valor aos campos da ferramenta: um valor fixo, uma variável de uma resposta anterior (por exemplo, {order_no}) ou o caminho para um campo de uma resposta anterior (por exemplo, {order.no}).
3. Em “Salvar em variáveis”, salve a resposta completa ou o código de erro em uma variável; você pode usá-la nas etapas seguintes como {variable}.
4. Conecte os ramos “Ao concluir” e “Se falhar”. Se a ferramenta não responder ou retornar um erro, o fluxo segue pelo ramo “Se falhar”. Se ele estiver vazio, a conversa é encerrada com uma mensagem de que algo deu errado. Se você quiser que o agente continue também após uma falha, conecte “Se falhar” à mesma etapa de “Ao concluir”.

Enquanto a ferramenta é executada, o visitante vê um texto como “Verificando os detalhes…” ou “Processando seu pedido…” (nas ferramentas da loja, o próprio trabalho, como “Buscando produtos…”). Você pode escrever seu próprio texto em “Texto mostrado durante a espera”.

Os subcampos dos campos Objeto de uma ferramenta são preenchidos em caixas separadas. Para uma lista cujos itens são Objetos, informe primeiro uma variável de lista em “Origem da lista” (por exemplo, a lista de uma ação ou o resultado de uma etapa Editar lista) e depois mapeie os campos do item em “Campos de cada item”, como {item.sku}. Cada item da origem vira uma linha na lista; se deixar o mapeamento vazio, os itens são enviados como estão.

Uma ferramenta que altera dados não é executada de novo quando o visitante pressiona voltar ou reenvia uma mensagem. Se a conversa passar por esta etapa de novo (por exemplo, voltando por um menu), ela é executada novamente. Uma ferramenta que lê dados é chamada toda vez que o visitante chega à etapa.

Se um campo obrigatório estiver vazio ou um valor não corresponder ao tipo do campo, a ferramenta não é chamada e a etapa segue por “Se falhar”. O editor mostra como aviso na etapa um valor fixo que não corresponde ao tipo. As chamadas aparecem na página “Ferramentas” › “Estatísticas de chamadas”.

Tentar novamente em caso de falha

Se você ativar “Tentar novamente em caso de falha” em uma etapa Ação de integração ou Chamada de ferramenta, a etapa é executada de novo em caso de erro temporário. Quando as tentativas acabam, o fluxo continua por “Se falhar”; se esse ramo estiver vazio, a conversa é encerrada com uma mensagem de que algo deu errado.

• “Máximo de tentativas”: de 2 a 5; 3 por padrão.
• “Espera entre tentativas (s)”: de 0 a 5 segundos; 1 por padrão.

Todas as tentativas levam no máximo 18 segundos; se o tempo acabar, as restantes são ignoradas.

Só erros temporários são repetidos: tempos esgotados, erros de conexão, quedas do fornecedor e limites de taxa. Em erros como falta de permissão ou campo vazio, a etapa vai direto para “Se falhar”.

Use com cuidado em etapas que criam um registro ou enviam uma mensagem: se o tempo esgotar, o pedido pode ter chegado ao fornecedor, e o mesmo registro ou mensagem pode ser criado duas vezes.