Dica
Utilize solicitações externas para enriquecer a interação com seu chatbot, obtendo informações em tempo real de APIs ou sistemas externos. Isso torna seus fluxos mais dinâmicos e personalizados, adaptando-se às necessidades do usuário.
Neste tutorial, você aprenderá a usar a função de Solicitação Externa no Chat.AI. Com essa funcionalidade, é possível integrar APIs de terceiros ou seu próprio servidor para solicitar ou enviar dados diretamente a partir do fluxo do seu chatbot.
Configurando a Solicitação Externa
- Localizando a Função:
- No Construtor de Fluxo, vá até a etapa de Ação.
- Selecione Ações Avançadas -> Solicitação Externa.
- Configurando a Solicitação:
- Escolha o tipo de solicitação (GET, POST, etc.).
- Cole o URL/endpoint da solicitação.
- Ajuste os Parâmetros de URL, Cabeçalhos, Corpo ou Autorização, se necessário. Por exemplo, configure a chave de API.
- Testando a Solicitação:
- Clique em Testar e a área de resposta exibirá o código de resposta.
- Você pode clicar em Cabeçalhos da Resposta para ver mais detalhes.
- Selecione a parte dos dados que você precisa clicando no círculo ao lado esquerdo da resposta.
- O caminho JSON dos dados selecionados aparecerá automaticamente.
- Escolha um Campo Personalizado para armazenar os dados e clique em Adicionar.
- Salvando a Configuração:
- Adicione quantos mapeamentos forem necessários e clique em Salvar.
Atenção
Certifique-se de fornecer dados de teste válidos para todas as variáveis antes de clicar em Testar. Isso garantirá que a solicitação funcione corretamente e que os dados sejam mapeados corretamente.
Configurações Específicas
- Parâmetros de URL:
- Se sua API requer parâmetros de URL, como um nome de usuário ou ID, você pode adicionar esses parâmetros na seção apropriada.
- Cabeçalhos:
- Para APIs que exigem cabeçalhos, adicione os nomes das chaves e variáveis nos cabeçalhos da solicitação.
- Autorização:
- Para solicitações que exigem um token de autorização, adicione o token diretamente na seção de Autorização. Isso evita erros comuns, como esquecer o prefixo “Bearer” antes do token.
- Para autenticação básica, insira o nome de usuário e a senha, e o sistema converterá esses valores automaticamente para base64.
- Corpo da Solicitação:
- Se sua API exige um corpo de solicitação, você pode usar multipart/form-data ou x-www-form-urlencoded.
- Também é possível colar o payload em formato JSON bruto no campo Conteúdo do Corpo e ajustar as variáveis conforme necessário.
Testando e Mapeando Dados
- Testar a Solicitação: Quando tudo estiver configurado, clique no botão Testar.
- Mapear Dados da Resposta: Expanda os cabeçalhos da resposta e selecione os dados que deseja salvar. O caminho JSON será gerado automaticamente, facilitando o mapeamento dos dados para os campos personalizados.
Com esses passos, você poderá integrar APIs e utilizar dados externos para criar um chatbot altamente interativo e adaptado às necessidades dos usuários.