Pular para o conteúdo principal

Chamada de API

Configure integrações personalizadas para que o chatbot possa buscar ou enviar informações em tempo real (ex: consultar status de pedido, buscar produtos, registrar chamados).

Você pode adicionar múltiplos endpoints, respeitando o limite de ações ativas do seu plano.

Detalhes do Endpoint​

Defina a identidade base da sua requisição:

  • Nome do endpoint: Um nome descritivo (Ex: Buscar cliente por e-mail).
  • Método: GET, POST, PUT, DELETE, etc.
  • URL: O endereço do recurso na API externa.

Autenticação​

Se a sua API exige segurança, clique no botão Autenticação para abrir o modal de configuração:

  • Método e URL de Autenticação: Define onde o WiseMind deve buscar o token.
  • Body e Headers: Envie as credenciais necessárias (ex: username e password em formato JSON).
  • Caminho do token na resposta: Notação de ponto para extrair o token (ex: data.access_token).
  • Expira em (s): Tempo de vida do token para que o WiseMind saiba quando renová-lo.

Instruções de Uso e Pós-execução​

Oriente o WiseMind sobre o comportamento da integração:

  • Quando esta ação deve ser utilizada?

    Explique o cenário ideal. Ex: "Use esta ação quando o cliente quiser consultar o status de um pedido. Peça o CPF antes de chamar a API."

  • Instruções pós-execução

    Diga como o assistente deve tratar a resposta. Ex: "Resuma a resposta da API em formato de lista amigável e pergunte se o cliente precisa de mais alguma coisa."

Dados Adicionais​

Adicione campos opcionais enviados na requisição quando necessário. O painel é dividido em abas:

  • Headers, Body, Path Params, Querystring
  • Você pode adicionar múltiplos itens definindo a Chave e o Valor em cada aba.

Dados do usuário identificado​

Se o seu site utiliza Identificação de Usuários, os claims verificados do JWT ficam disponíveis em qualquer campo da requisição (URL, Headers, Body, Path Params, Querystring) através da sintaxe {{identity.<claim>}}.

Exemplos:

GET https://api.seusite.com/customers/{{identity.account_id}}/orders
Authorization: Bearer {{identity.api_token}}

Os valores só são interpolados após a verificação da assinatura do token. Se o token estiver ausente, expirado ou inválido, a ação não é executada.

Testar Endpoint

Antes de salvar, você pode expandir a seção Testar Endpoint para simular uma requisição real com valores de exemplo e garantir que a configuração está correta.