Este passo permite o envio de solicitações HTTP e salvar suas respostas como variáveis.
Este passo só está disponível para o plano de Negócios e superior.
Existem duas configurações chave no passo de requisição HTTP:
O método específico necessário para o pedido. Escolha o método apropriado na lista de seleção.
No campo URL, insira o ponto de extremidade de URL da API externa para recuperar dados. Para incluir variáveis, use o prefixo "$" para suportar a interpolação do texto estático e variáveis.
Agora você pode usar os endereços IP e os números da porta no passo de requisição HTTP, dando-lhe acesso direto aos servidores e flexibilidade para acessar serviços em portas não padrão.
Por favor, note que tanto domínios respond.io quanto de rótulo branco estão na lista negra. Enviar uma chamada de API para esses domínios não é permitido, pois isso poderia causar problemas de repetição.
Para garantir a decodificação correta pelo destinatário da solicitação, expanda a seção Corpo e inclua um corpo juntamente com o cabeçalho de tipo de conteúdo.
Na seção Cabeçalho, você pode adicionar cabeçalhos para o pedido HTTP em pares. A chave representa o nome do cabeçalho, e o valor representa o valor do cabeçalho. Você pode usar variáveis como cabeçalhos adicionando o prefixo "$". No entanto, lembre-se de que apenas são permitidos 10 cabeçalhos.
Para respostas de API JSON com pares de valor chave, você pode salvar elementos de resposta específicos como variáveis. Na seção Mapeamento de respostas, insira a chave do objeto JSON à esquerda e atribua um nome à variável à direita. Tenha em mente que apenas respostas JSON podem ser salvas, e você pode ter um máximo de 10 configurações de mapeamento de resposta.
Exemplos:
Para salvar uma resposta em diferentes formatos, preencha a chave JSON correspondente aos dados que deseja salvar.
{
"nome": "Jason",
"códigos_postais": "12345",
"telefone": "123123"
}Para salvar o número de telefone da resposta acima, use $.phone como a chave JSON.
{
"campos_personalizados": {
"firstName": "João",
"lastName": "Doe",
"locale": "pt_GB",
"timezone": "5",
"gender": "masculino",
"phone": "123123",
"email": "[email protected]",
"customerid": "1"
},
"created_at": 1575618542
}Para salvar o número de telefone da resposta acima, use $.custom_fields.phone
{
"dados": {
"id":"1776025372480910",
"contatos": [
{
"primeiroNome":"João",
"sobrenome":"Doe",
"localidade": "en_GB"
},
{
"primeiroNome":"Jane",
"sobrenome":"Doe",
"localidade": "en_GB"
}
]
}
}Para salvar o primeiro nome 'Jane' da resposta acima, use $.data.contacts[1].firstName.
Para salvar o status de resposta da solicitação HTTP como uma variável, ative o Salvar Status de Resposta como variável. Então, nomeie a Variável no campo fornecido.
Quando ativado, esta etapa enviará uma requisição HTTP para a URL especificada, usando o corpo e cabeçalho definidos.
Você pode guiar o fluxo de trabalho com base no status da resposta. Por exemplo, você pode criar uma filial para o código de status "é igual a 200". Se qualquer outro código de status de resposta for recebido, um Passo de Salto pode retornar Contatos para o Passo de Requisição HTTP. Como alternativa, o contato pode ser direcionado para a Ramo de Falha, se as condições da ramificação não forem atendidas. Se não houver etapas configuradas sob o Ramo de Falha, o Fluxo de Trabalho será concluído.
Se a sua solicitação HTTP exceder 10 segundos, isso resultará em um tempo limite, causando a falha da solicitação.
Para evitar possíveis falhas na execução de solicitações HTTP, certifique-se de que as seguintes condições sejam atendidas:
Certifique-se de usar o método HTTP correto e o cabeçalho Content-Type.
Certifique-se de incluir o protocolo necessário http:// ou https:// na sua URL com base no que o sistema suporta para evitar falha na solicitação.
Certifique-se de que o tipo de conteúdo é válido.
Excluir o número da porta do URL.
Evite usar um certificado auto-assinado na URL.
Verifique se a autorização é válida.
Certifique-se de que nossos endereços IP (52.74.35.155, 18.138.31.163, 54.169.155.20) não estão bloqueados.
Se qualquer uma das condições acima não forem atendidas, o Contato pulará esta etapa e prosseguirá com a jornada restante.
Ao verificar saídas de solicitação HTTP com variáveis dinâmicas, lembre-se de que as Variáveis sem um valor retornarão como null e indefinida.
Aqui estão algumas das melhores práticas para este passo que você pode seguir para otimizar seu fluxo de trabalho:
Salvar Status da Resposta como uma Variável:
Certifique-se que o primeiro passo é para salvar o Status de Resposta como Variável para outras ações.
Passo da filial:
Adicione um Passo de Branch para avaliar o status do pedido HTTP.
Se o status é 200, a solicitação é bem sucedida.
Se não, configure um alerta para notificar o gerente sobre a solicitação não bem-sucedida.
Google Sheet para monitorar:
Registre o Status de Resposta em uma folha do Google para ter uma visibilidade clara sobre o sucesso ou falha das solicitações.
Comentário:
Adicione um comentário em seu fluxo de trabalho para documentar o status da resposta. Isso ajudará você a acompanhar e revisar os erros de forma mais eficiente.
Salvar Status da Resposta como uma Variável:
Semelhante ao pedido de sucesso, salvar Status de Resposta como Variável para manipulação de erros.
Use a Etapa de Espera ou de Salto para Repetições:
Implemente a Etapa de Espera para pausar antes de tentar novamente uma solicitação malsucedida.
Alternativamente, use a Etapa de Salto para retornar à Etapa de Solicitação HTTP e tentar novamente.
Comentário:
Documentar o erro criando um comentário para gravar o erro de requisição HTTP
Inclua os detalhes do contato e marque a pessoa responsável.
Planilha Google para Monitorar:
Utilize o Google Sheet Step para registrar as informações de contato e detalhes do erro para o monitoramento e revisão.
Tarefa Atribuída:
Atribuir a tarefa a um usuário específico para iniciar outro processo no fluxo de trabalho e tentar novamente.
Aqui estão algumas maneiras de usar o passo de solicitação HTTP:
Rotear contatos VIP: Utilize a etapa de solicitação HTTP para buscar detalhes de contato de um data warehouse como um CRM. Isso permite que você identifique contatos VIP, permitindo uma experiência personalizada de clientes e distinguindo-os de contatos que não sejam VIP.
Artigos relacionados 👩💻