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
- Selecione o bloco
Requisição HTTPno editor para abrir as configurações. - Na aba
Configuração, selecione oMétododa requisição:Get,Post,Put,PatchouDelete. - Em
Endpoint, informe a URL completa da API de destino. - Em
Cabeçalhos, adicione os cabeçalhos necessários. - Em
Dados da requisição, monte o corpo no modoVisualou digite o JSON na abaJSON. - O bloco tem duas saídas no editor:
SucessoeFalha. 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.
- No aviso, selecione
Guardar como segredo. - 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çãoe dê umNome da variável, comohorarios_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