Configurar as ferramentas dos assistentes
Caminho: Menu lateral → Opa! IA → Ferramentas
Visão geral
As ferramentas são as ações que um assistente inteligente pode executar durante a conversa, como transferir o atendimento, encerrá-lo, aplicar uma etiqueta ou consultar um sistema externo. Você cadastra cada ferramenta uma vez, com uma descrição de quando usá-la, e depois a inclui nas instruções ou no fluxo de interações de qualquer assistente. Assim, o assistente age sem depender de uma pessoa para cada tarefa.
Pré-requisitos
- Opa! IA contratado e permissão Ambiente de IA no grupo de permissões. Veja Criar e configurar um grupo de permissão.
- Os itens que a ferramenta usa já cadastrados: etiquetas, departamentos, usuários, fluxos de comunicação, agendas com pré-agendamentos ou o app HTTP.
Passo a passo
Cadastrar uma ferramenta
- Acesse Opa! IA → Ferramentas. A lista mostra Nome, Tipo, Descrição, Assistentes vinculados e Pronto para uso.
- Clique em Adicionar ferramenta. Abre a janela Adicionar nova ferramenta.
- Em Tipo da ferramenta, escolha o tipo.
- Preencha a Configuração do tipo (veja a seção a seguir) e salve.
A coluna Pronto para uso mostra Pronto ou Precisa de revisão. Uma ferramenta que precisa de revisão está com a configuração incompleta, e os assistentes que a usam podem falhar.
Usar a ferramenta em um assistente
- Abra o assistente, na aba Instruções ou Fluxo de interações.
- Digite / e escolha a ferramenta.
- Explique no texto quando e por que ela deve ser usada.
- Publique as alterações. Veja Configurar um assistente inteligente.
O assistente só usa a ferramenta quando entende o contexto. Escreva, por exemplo: "Se o cliente pedir segunda via, transfira o atendimento para o departamento Financeiro." Também preencha bem a Descrição da ferramenta, porque ela ajuda a IA a decidir quando acionar.
Tipos de ferramenta
Adicionar etiqueta
Aplica uma etiqueta ao atendimento, para classificar o assunto (por exemplo, "Suporte" ou "Financeiro").
- Etiqueta: escolha uma etiqueta da empresa ou crie uma nova. Etiquetas pessoais não podem ser usadas.
- Descrição: quando aplicar a etiqueta.
Transferir atendimento
Passa o atendimento para outro destino quando o assistente não puder resolver.
- Transferir para: escolha Departamento, Atendente ou Assistente.
- Escolha o departamento, o atendente ou o assistente de destino.
- Mensagem de transferência: o que o assistente diz ao cliente ao transferir.
- Descrição: quando transferir.
Encerrar atendimento
Permite que o assistente encerre o atendimento quando a demanda foi resolvida, sem intervenção humana.
- Nome e Descrição: identificam a ferramenta e dizem quando usá-la.
- Mensagem de encerramento: o que o assistente diz ao cliente ao encerrar.
Executar fluxo de comunicação
Entrega a conversa para um fluxo de comunicação já montado, que segue as etapas e regras configuradas.
- Fluxo de comunicação: o fluxo que será executado.
- Descrição: quando executar. Veja O que é o fluxo de comunicação.
Encaminhar arquivo
Envia ao cliente um arquivo que você cadastrou, como guia, catálogo, contrato ou QR Code.
- Nome e Descrição: identificam o arquivo e dizem quando enviá-lo.
- Selecionar arquivo: escolha ou arraste os arquivos. Aceita .pdf, .png, .jpg, .jpeg e .gif, com até 10 MB por arquivo.
Agendar horário
Deixa o cliente marcar um horário na Opa! Agenda pela conversa com o assistente.
- Agenda do usuário: a agenda onde o compromisso será registrado.
- Pré-agendamentos disponíveis: os serviços que o cliente pode escolher. Só aparecem os pré-agendamentos da agenda escolhida.
- Mensagem para solicitar o motivo do agendamento: o texto que pede ao cliente o serviço. O padrão é "Por favor, selecione o serviço desejado".
Antes, cadastre os pré-agendamentos. Veja Configurar o agendamento automático pelo WhatsApp.
Executar requisição HTTP
Conecta o assistente a um sistema externo por API, para consultar ou enviar dados, como validar um endereço, buscar coordenadas ou gerar um token.
- Em Opa! IA → Ferramentas, adicione uma ferramenta do tipo Executar requisição HTTP.
- Preencha Nome, Descrição e App HTTP (a integração HTTP instalada na Opa! Store). Veja Integração HTTP.
- Na barra de endereço, escolha o Método (GET, POST, PUT, PATCH ou DELETE) e informe a URL.
- Preencha, se precisar, Cabeçalhos e Parâmetros (pares de Nome e Valor) e o Corpo, em formato JSON. Nesses campos, use variáveis no formato
para os dados que mudam a cada atendimento. - Clique em Testar para ver a Resposta direto na tela, sem salvar.
- Em Mapeamento da resposta, escolha quais partes da resposta o assistente deve guardar. Informe a Origem (o caminho do dado na resposta) e Salvar como (o nome da variável). Use Mapear todos para guardar tudo. Exemplo de mapeamento:
{ "nomeUsuario": "data.user.name" }. - Clique em Salvar alterações.
Valores sensíveis, como chaves de API, ficam ocultos nos campos de valor.
Resultado esperado
A ferramenta aparece na lista com Pronto em Pronto para uso e pode ser inserida em qualquer assistente pela barra /. Ao abrir uma ferramenta, a seção Assistentes vinculados mostra quais assistentes a usam.
Regras e comportamentos
- Assistentes vinculados: consulte essa seção antes de alterar ou excluir uma ferramenta, para saber quais assistentes serão afetados. Uma ferramenta sem vínculo aparece como não utilizada.
- Excluir: use o menu Ações da ferramenta. Uma ferramenta excluída deixa de ser usada pelos assistentes.
- Auditoria: o botão Auditar da tela de ferramentas mostra as alterações feitas.
- Importação de assistentes: ao importar um assistente em outra instalação, as ferramentas não vêm junto. Cadastre-as de novo.
Problemas comuns
- Aparece "Precisa de revisão": abra a ferramenta e complete os campos obrigatórios.
- O assistente não usa a ferramenta: confira se ela está citada na instrução ou no fluxo, com o contexto de quando usar, e se o assistente foi publicado.
- A requisição HTTP não funciona: confira o App HTTP, a URL e as variáveis, e use Testar para ver a resposta.
Boas práticas
- Dê um nome e uma descrição claros a cada ferramenta.
- Use uma ferramenta por ação. Evite ferramentas que fazem várias coisas.
- Antes de excluir, confira os Assistentes vinculados.
- Teste a ferramenta na Pré-visualização do assistente antes de publicar.