Visão geral de ferramentas

Uma ferramenta é uma ação reutilizável que a Connectly pode executar para você, como consultar um pedido, verificar o estoque, criar um ticket ou salvar um registro. Você a cria uma vez na página Ferramentas e depois a usa nos seus agentes de IA, campanhas e WhatsApp Flows dinâmicos.

​

A página Ferramentas

Abra Ferramentas na barra lateral. A página tem quatro abas: A aba Ferramentas mostra estas colunas: Use a caixa de pesquisa para encontrar uma ferramenta pelo nome ou pela descrição. Você também pode filtrar por tipo ou campanha.

​

Criar uma ferramenta

​

Qual tipo devo usar?

​

Ferramentas de chamada de API

Uma ferramenta de API envia uma solicitação HTTP a um serviço quando é executada.

• Método e URL do endpoint: escolha o método HTTP e informe a URL. Use {parameter} para valores que mudam a cada chamada, por exemplo, https://api.example.com/orders/{order_id}.
• Cabeçalhos: adicione os cabeçalhos necessários para o serviço.
• Autenticação: escolha uma credencial salva ou selecione Novo recurso para criar uma (veja Autenticação).

​

Ferramentas de script JavaScript

Uma ferramenta de script executa seu JavaScript sempre que é chamada. Ela recebe os dados de entrada, executa o trabalho e retorna um resultado. O editor permite testar o script em tempo real e conferir a saída e os logs antes da publicação. Se o script importar outra ferramenta, o editor avisará quando ela usar uma versão antiga. Atualize a importação, faça o deploy e teste novamente para usar a versão mais recente.

​

Esquema de entrada e saída

Abra a aba Esquema para descrever sua ferramenta com JSON Schema:

• Esquema JSON de entrada: as informações que a ferramenta espera, por exemplo, uma string order_id.
• Esquema JSON de saída: o formato do resultado retornado.
• Resultado de exemplo: um exemplo de resultado típico.

Um bom esquema ajuda os agentes de IA a preencher os valores corretos e entender o resultado.

​

Autenticação

As ferramentas de API podem se autenticar no seu serviço. As credenciais são criptografadas e armazenadas com segurança. Depois de salvas, elas não voltam a ser exibidas em texto simples. As credenciais salvas aparecem na lista Selecionar recurso de autenticação, para que você possa reutilizá-las em várias ferramentas.

​

Testar sua ferramenta

Use o painel Teste ao lado do editor.

1. Em Entrada simulada, informe o JSON que a ferramenta deve receber, por exemplo, { "order_id": "12345" }.
2. Selecione Executar teste.
3. Confira o resultado na aba Saída e os detalhes na aba Logs. O status será SUCCESS ou ERROR.

​

Versões, rascunhos e publicação

Cada salvamento cria uma nova versão da ferramenta, para que você possa ver o que mudou e voltar a uma versão anterior.

• Use o seletor de versões na parte superior do editor para alternar entre versões.
• Ao salvar ou fazer deploy, escolha Incremento automático (a Connectly escolhe o próximo número) ou Versão personalizada (por exemplo, 2.0.0). A versão personalizada deve ser maior que a atual.
• Uma ferramenta começa como Rascunho. Selecione Publicar para disponibilizá-la. Você precisa salvar ou fazer deploy das alterações mais recentes antes de publicar.

O editor também mostra quem criou a ferramenta e quem editou cada versão pela última vez, o que é útil quando várias pessoas da equipe trabalham na mesma ferramenta. As edições assistidas por IA são identificadas como Assistente de IA.

​

Monitorar suas ferramentas

​

Execuções

A aba Execuções mostra cada execução, da mais recente para a mais antiga, e é atualizada conforme novas execuções chegam. Para cada uma, você pode ver o horário, a ferramenta, o status, a duração e o código de status. Selecione uma execução para abrir os logs, incluindo a execução, a sessão e a sala relacionadas. Use estes filtros para restringir a lista:

• Ferramenta: escolha uma ferramenta ou pesquise pelo nome (use | para pesquisar várias).
• Status: Sucesso ou Falha.
• Período: de 15 minutos a 15 dias, ou um período personalizado.
• ID da execução, ID da sessão ou ID da sala: vá diretamente para uma conversa ou execução.

​

Taxa de sucesso

A coluna Atividade na aba Ferramentas mostra rapidamente a saúde de cada ferramenta. Uma queda na taxa de sucesso costuma ser o primeiro sinal de que um serviço externo está fora do ar ou que uma credencial expirou.

​

Datastore

O Datastore é um armazenamento durável de chave e valor que suas ferramentas podem ler e gravar durante a execução, por exemplo, para lembrar a última escolha de um cliente.

• Navegue e filtre as chaves por prefixo e veja o valor, o tamanho e a última atualização de cada uma.
• Adicione, edite ou remova chaves. As alterações entram em vigor imediatamente.
• Restaure um estado anterior. Você pode restaurar qualquer momento dentro da janela de retrocesso exibida na página. A Connectly salva primeiro um ponto de restauração do estado atual, então também é possível desfazer uma reversão.

​

Compartilhar uma ferramenta

Você pode compartilhar uma ferramenta com outra empresa.

1. Abra a ação Compartilhar da ferramenta na lista.
2. Informe o ID da outra empresa e selecione Compartilhar.
3. Para parar de compartilhar, selecione Cancelar compartilhamento ao lado dessa empresa.

A outra empresa verá a ferramenta em Ferramentas compartilhadas. Ela poderá visualizá-la e testá-la, mas não editá-la. As execuções compartilhadas aparecem como Compartilhadas em Execuções.

​

Excluir uma ferramenta

Selecione Excluir na linha da ferramenta. Isso remove a ferramenta e todas as suas versões, e não pode ser desfeito. As ferramentas usadas por um WhatsApp Flow são gerenciadas com o fluxo. Elas são excluídas automaticamente quando o fluxo é excluído ou descontinuado. Consulte WhatsApp Flow Builder.

​

Solução de problemas

​

Próximas etapas