WhatsApp Messaging Flows - Etapa "Connect APIs"

Com o ActiveCampaign, você pode usar a etapa "Connect APIs" nos fluxos de WhatsApp Messaging para conectar qualquer solicitação que ofereça suporte a requisições de API. Essa funcionalidade permite estender seus fluxos integrando com sistemas externos, automatizando processos e recuperando ou enviando dados.

Este artigo explica a etapa "API" e traz alguns exemplos para ilustrar seu potencial.

Observação

Esta opção é para usuários avançados. Você precisa ter familiaridade com código. Nossa equipe de Experiência do Cliente não pode ajudar com a implementação ou solução de problemas de código.

Sobre a etapa "Conectar APIs"

A etapa "Connect APIs" permite fazer requisições HTTP para APIs externas. Você pode configurar esta etapa para enviar ou recuperar dados de outros sistemas, permitindo uma integração perfeita entre o ActiveCampaign e suas ferramentas existentes.

A etapa de API é compatível com vários métodos HTTP, incluindo GET, POST, PATCH, PUT e DELETE, e permite personalizar cabeçalhos, parâmetros de consulta e corpos de requisição.

Configure a etapa "Conectar APIs"

1. Clique em WhatsApp > Fluxos de mensagens no menu à esquerda.
2. Edite ou crie um novo Fluxo de Mensagens.
   • Se estiver editando um fluxo, clique em um fluxo > Atualizar > Etapas. Clique em um nó (+) no construtor onde você quer colocar a ação. Uma janela modal será exibida. Clique na opção "Conectar APIs" e clique no botão "Adicionar"
   • Se estiver criando um novo fluxo, uma janela modal será exibida no construtor de fluxos. Clique na opção "Conectar APIs", depois clique no botão "Adicionar"
3. No modal "Adicionar etapa" que aparece:
   • Clique no ícone de lápis e dê um nome à sua etapa. Recomendamos usar nomes únicos, curtos e descritivos
   • Tipo de método - Selecione o método HTTP adequado com base no seu caso de uso
   • URL - Insira a URL do endpoint externo da API ao qual você quer se conectar
   • Adicione os cabeçalhos de API necessários, como Body, Headers e Query. Se o endpoint da API exigir parâmetros de consulta, você pode adicioná-los aqui. Para requisições POST ou PATCH, defina o objeto JSON, formulário ou string que será enviado como corpo da requisição.
   • Solicitação de teste - Clique neste botão para testar a conexão com a API
   • Alternar formatação de caracteres de escape em variáveis - Se ativada, os caracteres especiais no texto da variável serão formatados

Exemplos

Exemplo 1: Enviando dados para um CRM

Suponha que você queira atualizar as informações de um contato no seu CRM sempre que ele concluir um fluxo no ActiveCampaign. Você pode usar a etapa "Connect APIs" para enviar uma solicitação POST à API do CRM com os dados atualizados do contato. Para fazer isso:

1. Defina o URL do seu CRM. Por exemplo, https://api.yourcrm.com/v1/contacts
2. Escolha POST para o método HTTP - POST
3. Configurar cabeçalhos:

{"
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json""
}

4. Definir corpo da solicitação:

{"
  "first_name": "{{contact.first_name}}","
  "last_name": "{{contact.last_name}}","
  "email": "{{contact.email}}","
  "phone": "{{contact.phone}}""
}

Exemplo 2: recuperando dados de um sistema externo

Imagine que você precisa recuperar o histórico de pedidos de um cliente em um sistema externo e apresentá-lo em um fluxo do WhatsApp Messaging. Você pode usar a etapa "Connect APIs" para fazer uma solicitação GET à API do sistema externo e usar os dados recuperados nas etapas seguintes do fluxo.

1. Defina o URL como: https://api.yourordersystem.com/v1/orders?user_id={{contact.id}}
2. Escolha GET como método HTTP
3. Configurar cabeçalhos:

{
  "Authorization": "Bearer YOUR_API_KEY""
}

A resposta da API pode ser usada no fluxo para exibir o histórico de pedidos do cliente.

Exemplo 3: Acionando um fluxo de trabalho externo

Suponha que você queira acionar um fluxo de trabalho externo sempre que um cliente concluir uma etapa específica em um fluxo do WhatsApp. Você pode usar a etapa "Connect APIs" para enviar uma solicitação POST à API do sistema externo, passando os dados necessários.

1. Defina o URL como: https://api.yourworkflowtool.com/v1/trigger
2. Escolha POST como método HTTP
3. Configurar cabeçalhos:

"Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"

4. Defina o corpo da solicitação:

{
  "user_id": "{{contact.phone}}","
  "event": "flow_completed",
}