Esta etapa permite enviar solicitações HTTP e salvar suas respostas como variáveis.
Esta etapa está disponível apenas para o plano Business e superiores.
Há duas configurações principais na Etapa de Solicitação HTTP:
O método específico necessário para a solicitação. Escolha o método apropriado na lista suspensa.
No campo URL, insira o ponto de extremidade da URL da API externa para recuperar dados. Para incluir variáveis, use o prefixo "$" para dar suporte à interpolação de texto estático e variáveis.
Agora você pode usar endereços IP e números de porta na etapa de solicitação HTTP, o que lhe dá acesso direto aos servidores e flexibilidade para acessar serviços em portas não padrão.
Observe que tanto o respond.io quanto os domínios de marca branca estão na lista negra. Não é permitido enviar uma chamada de API para esses domínios, pois isso pode causar problemas de loop.
Para garantir a decodificação correta pelo destinatário da solicitação, expanda a seção Corpo e inclua um corpo junto com o Cabeçalho do Tipo de Conteúdo.
Na seção Cabeçalho, você pode adicionar cabeçalhos à solicitação 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 10 cabeçalhos são permitidos.
Para respostas da API JSON com pares chave-valor, você pode salvar elementos de resposta específicos como Variáveis. Na seção Mapeamento de Resposta, insira a chave do objeto JSON à esquerda e atribua um nome à variável à direita. Tenha em mente que somente respostas JSON podem ser salvas e você pode ter no máximo 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": {
"primeiroNome": "John",
"sobrenome": "Doe",
"localidade": "pt\_GB",
"fuso horário": "5",
"gênero": "masculino",
"telefone": "123123",
"e-mail": "[email protected]",
"ID do cliente": "1"
},
"criado\_em": 1575618542
}
Para salvar o número de telefone da resposta acima, use $.custom_fields.phone
{
"dados": {
"identificação":"1776025372480910",
"contatos" : \[
{
"primeiroNome":"João",
"sobrenome":"Corça",
"localidade": "en\_GB"
},
{
"primeiroNome":"Jane",
"sobrenome":"Doe",
"localidade": "pt\_GB"
}
\]
}
}
Para salvar o primeiro nome 'Jane' da resposta acima, use $.data.contacts[1].firstName.
Para salvar o status da resposta da solicitação HTTP como uma variável, ative a opção Salvar status da resposta como variável . Em seguida, nomeie a variável no campo fornecido.
Quando ativada, esta etapa enviará uma solicitação HTTP para a URL especificada, usando o corpo e o cabeçalho definidos.
Você pode orientar o fluxo de trabalho com base no status da resposta. Por exemplo, você pode criar uma ramificação para "cujo código de status é igual a 200". Se qualquer outro código de status de resposta for recebido, uma Etapa de Salto poderá retornar os Contatos para a Etapa de Solicitação HTTP. Alternativamente, o contato pode ser direcionado para a filial com falha se as condições da filial não forem atendidas. Se não houver etapas configuradas no Ramo de Falha, o Fluxo de Trabalho será concluído.
Se sua solicitação HTTP exceder 10 segundos, isso resultará em um tempo limite, causando falha na solicitação.
Para evitar possíveis falhas na execução de solicitações HTTP, certifique-se de que as seguintes condições sejam atendidas:
Use o método HTTP correto e o cabeçalho Content-Type.
Certifique-se de incluir o protocolo necessário http:// ou https:// em sua URL com base no que seu sistema suporta para evitar falhas de solicitação.
Certifique-se de que o Content-Type seja válido.
Exclua o número da porta do URL.
Evite usar um certificado autoassinado 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 estejam bloqueados.
Se alguma das condições acima não for atendida, o Contato pulará esta etapa e prosseguirá com a viagem restante.
Ao verificar as saídas de solicitações HTTP com variáveis dinâmicas, lembre-se de que variáveis sem um valor retornarão como null e undefined.
Aqui estão algumas das melhores práticas para este passo que você pode seguir para otimizar seu fluxo de trabalho:
Salvar status de resposta como uma variável:
Certifique-se de que o primeiro passo é salvar o Status de Resposta como Variável para ações futuras.
Etapa de ramificação:
Adicione uma etapa de ramificação para avaliar o status da solicitação HTTP.
Se o status for 200, a solicitação foi bem-sucedida.
Caso contrário, configure um alerta para notificar o gerente sobre a solicitação malsucedida.
Planilha Google para Monitoramento:
Registre o status da resposta em uma planilha do Google para ter uma visibilidade clara sobre o sucesso ou falha das solicitações.
Comentário:
Adicione um comentário no seu fluxo de trabalho para documentar o status da resposta. Isso ajudará você a rastrear e revisar erros com mais eficiência.
Salvar status de resposta como uma variável:
Semelhante à solicitação bem-sucedida, salva o Status da Resposta como Variável para tratamento de erros.
Use Wait ou Jump Step para novas tentativas:
Implemente a Etapa de Espera para pausar antes de tentar novamente uma solicitação malsucedida.
Como alternativa, use a Etapa de salto para retornar à Etapa de solicitação HTTP e tentar a solicitação novamente.
Comentário:
Documente o erro criando um comentário para registrar o erro da solicitação HTTP
Inclua detalhes de contato e marque a pessoa responsável.
Planilha do Google para monitoramento:
Utilize a Planilha Google para registrar as informações de contato e os detalhes do erro para monitoramento e revisão.
Atribuição de tarefa:
Atribua a tarefa a um usuário específico para iniciar outro processo dentro do fluxo de trabalho e tente novamente.
Aqui estão algumas maneiras de usar a Etapa 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 ao cliente e distinguindo-os de Contatos não VIP.
Artigos relacionados 👩💻
