Custom Actions e HTTP Request em Workflows

Nem toda automação se resolve com as ações nativas da plataforma. Às vezes, você precisa enviar dados para um sistema externo, consultar uma API ou acionar um webhook personalizado. Para isso, a Marketek oferece as Custom Actions e a ação HTTP Request dentro dos workflows.

O que São Custom Actions

Custom Actions são ações personalizadas que você cria para reutilizar em múltiplos workflows. Elas encapsulam uma configuração de requisição HTTP (URL, método, headers, body) em um bloco nomeado, facilitando a manutenção e o reuso.

Usando HTTP Request Diretamente

Se você precisa de uma integração pontual, pode usar a ação HTTP Request diretamente no workflow sem criar uma Custom Action.

📌 Passo 1 — Adicione a ação ao workflow

No editor de workflow, clique em + Adicionar Ação e selecione HTTP Request na categória Avançado.

📌 Passo 2 — Configure a URL e o método

Preencha os campos:

📌 Passo 3 — Defina os headers

Adicione headers clicando em + Header. Headers comuns incluem:

• Authorization: Bearer SEU_TOKEN
• Content-Type: application/json
• X-Custom-Header: valor

📌 Passo 4 — Configure o body

Para métodos POST, PUT e PATCH, defina o corpo da requisição em JSON. Você pode usar variáveis dinâmicas:

{
  "nome": "{{contact.first_name}}",
  "email": "{{contact.email}}",
  "telefone": "{{contact.phone}}",
  "origem": ""
}

📌 Passo 5 — Mapeie a resposta

Após a requisição, você pode capturar valores da resposta e salvá-los em campos do contato:

• Ative Mapear Resposta.
• Defina o caminho JSON do valor desejado (ex.: data.id).
• Escolha o campo do contato onde o valor será armazenado.

Criando uma Custom Action Reutilizável

📌 Passo 1 — Acesse Custom Actions

Vá em Automações → Custom Actions → + Nova Action.

📌 Passo 2 — Configure a action

Preencha nome, descrição e configure URL, método, headers e body template da mesma forma que no HTTP Request direto.

📌 Passo 3 — Defina parâmetros de entrada

Adicione parâmetros que serão preenchidos dinamicamente quando a action for usada em um workflow. Exemplo: parâmetro lead_email que recebe {{contact.email}}.

📌 Passo 4 — Salve e use nos workflows

Após salvar, a Custom Action aparece na lista de ações do editor de workflow sob Custom Actions. Basta arrastá-la e mapear os parâmetros.

Tratamento de Erros

• Timeout: defina um limite de tempo (padrão: 30 segundos). Se excedido, a ação falha e segue pelo ramo de erro.
• Ramo de erro: no editor, conecte um caminho alternativo ao nó de HTTP Request para tratar falhas (ex.: notificar administrador).
• Retry: ative tentativas automáticas (1 a 3 retries) com intervalo configurável.