Enviar webhook da mensagem acionada

A ação "Enviar webhook da mensagem acionada" permite enviar para um sistema externo os dados relacionados à mensagem do cliente que acionou a inscrição dele no fluxo. 

Pré-requisitos para usar este bloco:

• O Bloco de gatilho é um dos seguintes:
  - Mensagem recebida
  - Mensagem enviada
  - Mensagem recebida de um anúncio Click-to-WhatsApp (CTWA)
• O sistema externo consegue receber webhooks de entrada da SleekFlow

Configurar o Bloco de Ação "Enviar webhook da mensagem acionada"

1. Clique no Bloco de Ação Enviar webhook da mensagem acionada para abrir o formulário, que será exibido no lado direito da tela

2. O formulário do bloco contém os seguintes campos para você configurar, para que a SleekFlow envie ao seu sistema externo os dados do payload do webhook da mensagem acionada:

• Aba Configurar
  • URL: insira a URL do webhook fornecida pelo sistema externo para o qual você quer enviar os dados
  • Cabeçalhos: ative esta opção para fornecer quaisquer dados adicionais exigidos pelo webhook por meio dos cabeçalhos da solicitação. Consulte a documentação de webhook do seu sistema externo para verificar se é necessário enviar dados adicionais pelos cabeçalhos da solicitação do seu webhook.
  • Pré-visualizar carga útil (payload): você verá um exemplo da carga útil (payload) e dos parâmetros que seriam enviados ao webhook do seu sistema externo. A estrutura de dados do payload será exibida em sintaxe JSON

Enviar webhook do contato

A ação "Enviar webhook do contato" permite enviar para um sistema externo os dados relacionados ao contato inscrito no fluxo. Um pré-requisito para usar este bloco é que o sistema externo consiga receber webhooks de entrada da SleekFlow.

Configurar o Bloco de Ação "Enviar webhook do contato"

1. Clique no Bloco de Ação Enviar webhook do contato para abrir o formulário, que será exibido no lado direito da tela

2. O formulário do bloco contém os seguintes campos para você configurar, para que a SleekFlow envie ao seu sistema externo os dados do payload do webhook do contato inscrito:

• Aba Configurar
  • URL: insira a URL do webhook fornecida pelo sistema externo para o qual você quer enviar os dados
  • Cabeçalhos: ative esta opção para fornecer quaisquer dados adicionais exigidos pelo webhook por meio dos cabeçalhos da solicitação. Consulte a documentação de webhook do seu sistema externo para verificar se é necessário enviar dados adicionais pelos cabeçalhos da solicitação do seu webhook.
  • Pré-visualizar carga útil (payload): você verá um exemplo da carga útil (payload) do contato e dos parâmetros que seriam enviados ao webhook do seu sistema externo. A estrutura de dados do payload será exibida em sintaxe JSON

Enviar solicitação HTTP 

A ação "Enviar solicitação HTTP" permite enviar e/ou receber dados entre a SleekFlow e a API do seu sistema externo. Um pré-requisito para usar este bloco é que o sistema externo ofereça uma API disponível publicamente para permitir a integração com a SleekFlow.

Configure o formulário do Bloco de Ação "Enviar solicitação HTTP" seguindo as etapas descritas abaixo:

1. Configurar a solicitação HTTP
2. Configurar o corpo da solicitação HTTP
3. Configurar a persistência da resposta a partir da resposta HTTP

Configurar o Bloco de Ação “Enviar solicitação HTTP” 

1. Clique no Bloco de Ação Enviar solicitação HTTP para abrir o formulário, que será exibido no lado direito da tela

2. O formulário do bloco contém os seguintes campos para você configurar, para que a SleekFlow interaja com o seu sistema externo para enviar e/ou buscar dados:

• Aba Configurar
  • Método: especifique o método HTTP esperado pela API do seu sistema externo. 
    • GET: escolha “GET” para solicitar dados da API do sistema externo
    • POST: escolha “POST” para enviar dados da SleekFlow para o sistema externo por meio da API
    • PUT: escolha “PUT” para atualizar ou substituir dados existentes no sistema externo por meio da API
    • DELETE: escolha “DELETE” para remover dados existentes do sistema externo por meio da API

• URL: insira a URL para acessar a API do seu sistema externo e suas diferentes funcionalidades
• Cabeçalhos: configure os pares de chave e valor obrigatórios dos cabeçalhos da solicitação HTTP para acessar a API
• Cadeia de consulta: configure os pares de chave e valor obrigatórios da cadeia de consulta para acessar a API

• Tratar erro: ative esta opção para configurar um caminho alternativo sempre que uma solicitação HTTP falhar. Quando ativada:
  • Um ramo adicional será exibido no fluxo, especificamente para solicitações com falha
  • Você pode configurar esse ramo para definir o que deve acontecer quando a solicitação não puder ser concluída, por exemplo, o envio de uma mensagem de erro

Configurar o corpo da solicitação HTTP

A seção “Corpo” do formulário do bloco permite configurar os dados e o tipo de conteúdo que serão enviados pela solicitação HTTP ao servidor de API do sistema externo. Consulte a documentação da API do seu sistema externo para verificar as configurações e os parâmetros específicos exigidos para a integração.

Esta seção contém os seguintes campos que você pode configurar:

• Tipo de corpo: especifique o tipo de corpo aceito pela API do seu sistema externo. Você pode configurar o tipo de conteúdo usando as opções descritas na tabela abaixo:

Tipo de corpo	Descrição
raw	Escolha o tipo de corpo raw se a sua API receber dados em texto simples, JSON ou string. Especifique o tipo de conteúdo aceito pelo servidor da sua API: Text (text/plain), JSON (application/json), XML (application/xml), HTML (text/html) ou XML (text/xml)   Você pode inserir os dados na caixa azul-escura de conteúdo da solicitação usando a sintaxe correspondente ao tipo de conteúdo
Form-data ou x-www-form-urlencoded	Escolha o tipo de corpo que atenda aos requisitos da sua API e insira os dados do conteúdo da solicitação como pares de chave e valor     Se você tiver mais de um conjunto de dados em pares de chave e valor para adicionar, clique em “+ Adicionar conjunto” para incluir outro conjunto de pares de chave e valor

Configurar a persistência da resposta a partir da resposta HTTP

Depois de configurar a solicitação HTTP, você pode analisar as respostas da API diretamente pela aba Variáveis. Isso facilita a extração de campos de dados específicos do seu sistema externo e o uso dessas informações posteriormente no fluxo, sem precisar escrever caminhos JSON manualmente.

Como analisar respostas da API

1. Acesse a aba Variáveis no formulário do bloco Enviar solicitação HTTP
2. Cole um payload de resposta de exemplo do seu sistema externo na caixa de entrada.
3. Clique em Analisar dados.
4. A SleekFlow analisará o payload e detectará automaticamente todos os campos disponíveis na resposta
5. Após a análise, esses campos se tornarão variáveis que você poderá:
   • Inserir em mensagens de saída
   • Usar como condições para ramificação ou roteamento de contatos
   • Salvar para referência posterior em blocos de ação subsequentes