atualizado em

Bloco Requisição HTTP

Faça chamadas HTTP para APIs externas, envie dados do fluxo e use a resposta nos próximos blocos.

Nesta página

O bloco Requisição HTTP envia dados da automação para uma API externa. A resposta pode ser salva em campos personalizados do contato ou guardada só nesta execução, para os próximos blocos.

Quando usar

Use para integrar sua automação a ferramentas externas: criar leads em um CRM, consultar dados de um cliente ou avisar outro sistema.

Configure o bloco

  1. Selecione o bloco Requisição HTTP no editor para abrir as configurações.
  2. Na aba Configuração, selecione o Método da requisição: Get, Post, Put, Patch ou Delete.
  3. Em Endpoint, informe a URL completa da API de destino.
  4. Em Cabeçalhos, adicione os cabeçalhos necessários.
  5. Em Dados da requisição, monte o corpo no modo Visual ou digite o JSON na aba JSON.
  6. O bloco tem duas saídas no editor: Sucesso e Falha. Ligue cada uma ao próximo passo correspondente.

Escreva o JSON

Na aba JSON, o corpo é um editor de código: ele colore o JSON, indenta sozinho, fecha chaves e colchetes e marca na linha um erro de digitação. Selecione Formatar para organizar o JSON.

Cada {variável} do corpo fica destacada. Digite { para ver a lista de variáveis e buscar pelo nome ou pelo rótulo do campo.

As caixas de requisição e de resposta do teste usam o mesmo editor, só para leitura.

Corrija uma variável desconhecida

Quando os Dados da requisição usam uma variável que o fluxo não conhece, o bloco avisa: abaixo dos campos, no modo Visual, e abaixo do editor, no modo JSON. O aviso diz se a variável vai vazia ou como está escrita.

Se você escreveu {contact.…} com o nome de um campo da conta, como {contact.email}, o aviso oferece Trocar por o campo certo. Selecione para corrigir.

Guarde a chave da API como segredo

Quando você digita uma chave num cabeçalho de autorização, o bloco avisa que ela fica visível para quem abre a automação e vai junto em cada cópia dela.

  1. No aviso, selecione Guardar como segredo.
  2. A chave vira um segredo da conta, preso ao domínio do endpoint, e o cabeçalho passa a mostrar {secret.…} no lugar dela.

Para guardar a chave, o Endpoint precisa estar completo, sem variável. Quem não tem a permissão de segredos precisa pedir a alguém com ela. Os segredos ficam em Variáveis da conta.

Use a resposta

Na aba Mapeamento, selecione Adicionar mapeamento para ler um caminho da resposta JSON:

  • Para salvar no contato, escolha o campo personalizado de destino.
  • Para usar só no fluxo, marque Guardar só nesta execução e dê um Nome da variável, como horarios_livres. Os próximos blocos usam o valor, mas ele não vira campo do contato.
  • Para pegar todos os valores de uma lista, marque Guardar todos os resultados (lista) e use [*] no caminho, como $.horarios[*].inicio. A lista fica só nesta execução.

Em Guardar a resposta inteira em, dê o nome de uma variável para guardar a resposta toda (até 64 KB) e ler num bloco seguinte, como o Bloco Código, o que o mapeamento não pega.

As integrações da Gaio são de saída: a automação envia dados para sistemas externos, mas nenhuma chamada externa inicia uma automação.

requisição HTTP, integração, API, variável desconhecida, corpo da requisição, JSON

Perguntas frequentes

Dar feedback

Este recurso foi útil?

A seguir

Bloco Código

Rode um código JavaScript com as variáveis do fluxo e use o resultado nos próximos blocos.

Ler mais