Com a SendFlow AI, você pode integrar APIs externas e incorporá-las ao Construtor de Fluxo para aprimorar os recursos de automação do seu chatbot. Esse recurso permite uma conexão perfeita entre a SendFlow AI e plataformas externas para tarefas como recuperação de dados, envios de formulários, atualizações de usuários e muito mais.

Aqui está um guia passo a passo sobre como configurar e integrar uma API HTTP.

---

Etapa 1: Acesse a Seção de API HTTP #

1. No painel da SendFlow AI, navegue até a seção “API HTTP do WhatsApp” em Integração > API HTTP. É aqui que você pode visualizar suas conexões de API atuais e adicionar novas.
2. Clique no botão “Criar” para começar a configurar uma nova conexão de API.

Etapa 2: Adicione os Detalhes da Conexão da API #

Nesta seção, você configurará os detalhes para se conectar a serviços externos:

• Nome da API: Forneça um nome reconhecível para sua conexão (ex: “Criação de Usuário do WordPress”).
• Método: Selecione o método HTTP apropriado (POST, GET, etc.) que corresponda aos requisitos da API externa.
• URL do Endpoint: Insira a URL completa da API externa à qual você deseja se conectar (ex: https://example.com/api/v1/users/create).
• ID do Assinante de Teste: Insira o ID do seu próprio número de telefone. Ele é usado para testar a chamada da API, pois alguns dados dinâmicos podem ser necessários para a requisição.

Etapa 3: Configure os Cabeçalhos da Requisição (Headers) #

Nesta seção, você precisa definir todos os cabeçalhos HTTP necessários para fazer a requisição da API:

• Content-Type: Defina como application/json ou outro tipo de conteúdo, dependendo das especificações da API.
• Authorization: Se a API exigir autorização (como autenticação básica ou um token), adicione o cabeçalho relevante com o token ou as credenciais necessárias.
  • Exemplo: Authorization: Bearer SEU_TOKEN_AQUI

Etapa 4: Configure o Corpo da Requisição (Body) (Opcional) #

Se a sua requisição de API exige que dados sejam enviados no corpo (geralmente para requisições POST ou PUT), configure os campos nesta seção:

• Campos de Dados do Corpo: Adicione os campos necessários que a API espera receber. Por exemplo, o corpo pode incluir dados do usuário como username, first_name, last_name e email.
• Tipo de Valor: Você pode definir se cada campo terá um valor estático (fixo) ou dinâmico (extraído da entrada do usuário ou de dados do sistema).
• Formato dos Dados: Você pode alternar entre os formatos dados de formulário, x-www-form-urlencoded e bruto (raw), dependendo dos requisitos da API que você está utilizando.

Etapa 5: Salve e Verifique a Conexão #

Depois de preencher todos os campos obrigatórios:

1. Clique no botão “Verificar conexão”. A SendFlow AI enviará uma requisição de teste para a API externa para garantir que tudo esteja configurado corretamente.
2. Após a verificação bem-sucedida, clique em “Salvar API” para finalizar a conexão.

Etapa 6: Mapeie os Dados de Resposta da API #

Após uma conexão de API bem-sucedida, você pode mapear os dados recebidos na resposta de volta para seu fluxo de trabalho:

• Mapeamento de Resposta da API HTTP: Esta seção permite que você associe campos da resposta da API a dados do assinante ou a outras variáveis dentro da SendFlow AI.
  • Exemplo: Se a API retornar um user_id ou email, você pode mapear essas informações de volta para o perfil do assinante na SendFlow AI.
• Você também pode salvar itens de uma lista (array) da resposta. Eles serão salvos como JSON e podem ser usados para criar uma lista dinâmica para mensagens interativas no seu bot do WhatsApp.

Etapa 7: Use no Construtor de Fluxo #

Depois que sua API estiver integrada e o mapeamento de resposta estiver configurado, você poderá usar essa conexão de API no seu Construtor de Fluxo para acionar chamadas de API em diferentes pontos da conversa do seu chatbot.

• Elemento API HTTP: Dentro do Construtor de Fluxo, você pode adicionar o elemento API HTTP em qualquer lugar que desejar.
• Configure o Gatilho: Defina quando e como a API deve ser chamada com base nas interações do usuário (por exemplo, após uma pergunta específica ou ao clicar em um botão).

Resumo #

Com essa configuração, você pode integrar totalmente APIs externas aos seus fluxos de trabalho da SendFlow AI, permitindo ações como criar usuários, recuperar dados de assinantes ou atualizar sistemas externos diretamente dos fluxos do seu chatbot da SendFlow AI.

Para obter documentação mais detalhada sobre cada etapa da conexão de API ou sobre configurações avançadas, consulte nossa equipe de suporte ou visite a central de ajuda.