A solicitação externa (recurso Pro) permite que você estabeleça uma conexão com qualquer integração via solicitação HTTP, caso nossas integrações nativas não ofereçam suporte ao seu caso específico. Neste artigo, abordaremos:
Tipos de dados e métodos compatíveis
Este recurso permite enviar diferentes tipos de dados para um servidor externo, incluindo dados de contato como:
- Status do contato
- Primeiro nome
- Sobrenome
- Nome
- Gênero
- Idioma
- Fuso horário
- URL do Live Chat
- Campos de usuário personalizados
Os métodos HTTP compatíveis são POST, GET, PUT e DELETE.
Como configurar uma solicitação externa
Para criar uma solicitação externa, adicione um bloco de ação à sua automação:
Em seguida, vá para Automação → Fazer solicitação externa:
Depois de clicar em Adicionar sua solicitação, a janela de configuração será aberta:
Na janela de configuração, você poderá escolher um tipo de solicitação (POST, GET, PUT, DELETE):
Depois de especificar o tipo de solicitação, você precisará inserir o URL da solicitação e preencher os cabeçalhos, se necessário.
⚠️ Observação: somente links HTTPS são permitidos.
Se você estiver enviando uma solicitação POST ou PUT, o próximo passo será preencher o corpo da solicitação no formato JSON. Aqui está um exemplo:
{
"id": 123456,
"first_name": "John",
"last_name": "Doe",
"email": "me@mail.com"
}
Depois de concluir, você poderá testar sua solicitação selecionando um contato para teste, alternando para a guia Resposta e clicando no botão Testar solicitação:
Se tudo estiver configurado corretamente, você receberá um código HTTP 200 como este:
Exemplo de caso de uso
Existe um bom serviço de teste de API gratuito chamado SWAPI, então vamos criar uma automação de resposta padrão para fãs de Star Wars. Queremos obter o título do filme e a abertura enviando qualquer palavra em uma mensagem para a página do Facebook. Se a palavra estiver no título, a página responderá com as informações mencionadas.
Primeiro, crie dois campos de usuário personalizados do tipo texto para o título e o texto de abertura. Em seguida, vá para a automação de resposta padrão, crie um bloco de ação e escolha uma solicitação externa.
Faremos uma solicitação GET para https://swapi.co/api/films/?search= para procurar um filme com a última entrada de texto de um contato anexada ao final do link. Por último, precisamos especificar Caminhos JSON na guia de mapeamento de resposta para salvar o título do filme e abrir os valores de rastreamento da resposta para os campos de usuário personalizados correspondentes.
Depois de salvar as alterações e ativar a automação, isso é o que veremos no Facebook Messenger: