1) Abrir a caixa de ferramentas
• Ir para Workforce → selecionar o Worker → Caixa de ferramentas → Criar ferramenta.
────────────────────────────────────────
2) Escolher o tipo
• Tipo de Ferramenta: Solicitação HTTP.
────────────────────────────────────────
3) Preencher os dados básicos
• Nome: curto e descritivo (ex.: crm_buscar_cliente).
• Descrição: uma frase sobre o propósito.
• URL: cole a URL base ou completa do endpoint (https).
• Método: GET, POST, PUT, DELETE, PATCH.
• Endpoint (se sua URL estiver dividida): complete o path.
• Incluir resposta: marque Body e/ou Status conforme o que você precisa que a IA interprete.
────────────────────────────────────────
4) Headers (opcional, mas comum)
• Adicionar Header → insira pares chave/valor (ex.: Authorization: Bearer <TOKEN>, Content-Type: application/json).
────────────────────────────────────────
5) Body — como criar objetos, arrays e referenciar Inputs
• Adicionar Campos do Body → defina o Nome do campo.
• Cada campo possui:
- Botão {}: transforma o campo em **objeto** ou **array** (aninhado).
- Botão Tt: insere **Inputs** (valores dinâmicos que a IA extrai da conversa).
A) Objeto simples
1) Crie um campo pai (ex.: filial).
2) Clique em {} para transformá-lo em objeto.
3) Dentro, adicione novos valores para as chaves filhas:
- nome_filial = "BSAS"
- id_filial = 12
Resultado conceitual:
{
"filial": {
"nome_filial": "BSAS",
"id_filial": 12
}
}
B) Array (lista)
1) Crie um campo (ex.: filiais) e clique em {} para transformá-lo em array.
2) Dentro do array, Adicionar novo valor cria os itens.
3) Cada item pode ser simples ou um objeto (clique em {} no item).
Exemplo:
{
"filiais": [
{ "nome_filial": "BSAS", "id_filial": 12 },
{ "nome_filial": "Rosário", "id_filial": 22 }
]
}
C) Usar Inputs dentro do Body
• Para referenciar um Input no valor de um campo, use:
{input:nome_do_input}
Exemplos:
Inputs (extraídos pela IA da conversa)
- nome → “Nome da pessoa”
- id_cliente
- cidade
- sku_1, sku_2
Body
- name → {input:nome}
- cliente ({} objeto)
• id → {input:id_cliente}
• cidade → {input:cidade}
- items ({} array)
• item 1 ({} objeto): sku → {input:sku_1}, qty → 1
• item 2 ({} objeto): sku → {input:sku_2}, qty → 2
→
{
"name": "Sofía",
"cliente": { "id": 123, "cidade": "Córdoba" },
"items": [
{ "sku": "ABC", "qty": 1 },
{ "sku": "XYZ", "qty": 2 }
]
}
Dicas para o Body
• Nomeie claramente campos/itens; evite espaços.
• Se a API espera JSON, adicione Content-Type: application/json em Headers.
• Use Tt para inserir Inputs e evitar erros de sintaxe.
────────────────────────────────────────
6) Inputs (parâmetros dinâmicos que a IA extrai do chat)
• Adicionar Input → defina nome e descrição (ex.: email, documento, cidade).
• Lembrete: dentro de Body/Query/Headers, referencie com {input:nome}.
────────────────────────────────────────
7) Salvar e testar
• Salvar.
• Em Automações de etapas, defina quando usar a ferramenta.
• Testar agora:
- Verifique o Status (200/4xx/5xx).
- Revise o Body retornado (as chaves que a IA usará).
- Ajuste Headers/Body/Inputs se não corresponder à documentação da API.
• Na conversa, você pode ver quando a IA usa a ferramenta e qual foi a resposta HTTP (status e body). Isso permite auditar e depurar cada chamada com facilidade.