Requisição externa: enviar e receber dados de outro sistema

Passo 1: Adicione a requisição

Na etapa, clique em Adicionar Conteúdo e depois em Ações. A requisição fica perto do fim da lista, com o nome em inglês.

1. External API Request: o cartão entra na etapa. Clique nele para abrir a janela External Request.

Passo 2: Diga para onde a requisição vai

No topo da janela, escolha o método e o endereço. Na aba Cabeçalhos, monte os cabeçalhos que a API pede.

1. Request Type: GET, POST, PUT, PATCH ou DELETE, como a documentação da API mandar.
2. Request URL: o endereço. Pode levar dados do contato: digite { e escolha o campo.
3. As abas da janela: Cabeçalhos, Corpo, Mapeamento de resposta e Testar Agora.
4. Um cabeçalho por linha: o nome à esquerda e o valor à direita, como Authorization e Bearer seguido da chave. Clique em Adicionar para mais uma linha.

Passo 3: Monte o corpo

Na aba Corpo, escolha o formato. Com GET, a aba fica desligada.

1. O formato do corpo.
2. O JSON. Use aspas duplas e digite { para inserir campos, como "{{full_name}}".

Os formatos:

• Todos os dados do contato: manda os dados do contato. Marque Incluir tags do contato e Incluir campos personalizados do contato para juntar as etiquetas e os campos.
• JSON: você escreve o JSON.
• Form-encoded: pares de nome e valor, com Adicionar.

Passo 4: Guarde a resposta em campos

Na aba Mapeamento de resposta, ligue cada dado da resposta a um campo do contato.

1. JSONPath: o caminho do dado na resposta. $.cliente.id quer dizer: dentro de cliente, o valor de id. O ícone ao lado abre um site que ajuda a achar o caminho.
2. Salvar em um campo personalizado: o campo que recebe o valor.

Clique em Adicionar para mais uma linha.

Passo 5: Teste antes de salvar

Abra Testar Agora e clique no botão Testar Agora. Escolha o canal em Selecionar canal e clique em Continuar.

1. Código do estado: a resposta da API. 200 é sucesso; códigos de 400 em diante indicam erro.
2. Corpo da resposta: o que a API devolveu. Use para conferir os caminhos do Mapeamento de resposta.

Embaixo ficam Cabeçalhos da resposta, Cabeçalhos da solicitação e Corpo da solicitação: clique no nome para abrir. Depois, clique em Salvar.

Passo 6: Ligue Sucesso e Falhado

No quadro, a requisição ganha duas saídas. Ligue cada uma à próxima etapa.

1. Sucesso: siga para a etapa que usa os campos preenchidos, como uma mensagem com {{Código do cliente}}.
2. Falhado: siga para um caminho de reserva, como uma mensagem de "tente mais tarde" ou a passagem para a equipe.

Passo 7: Publique o fluxo

Clique em Publicar, no topo do editor.

1. Publicar: o contato só passa pela versão publicada.