Se a ideia de "chamar uma API" parece coisa de programador, respira: com o Zapier você não escreve nenhuma linha de código. Você monta um Zap — uma automação em blocos — dizendo "quando isto acontecer, faça aquilo". O GS Engage entra nesse "faça aquilo".

Nesta página você vai montar, do zero, uma automação real: quando alguém preenche um formulário, o GS Engage cria o lead, coloca numa cadência e distribui para um vendedor — tudo sozinho, na hora.

O GS Engage tem gatilhos nativos no Zapier (por exemplo, avisos de webhook — falamos deles mais adiante). Mas para enviar dados para o GS Engage — como criar um lead — você usa um bloco genérico e poderoso do próprio Zapier: o Webhooks by Zapier.

Esse bloco é o seu "telefone" para qualquer API. O endpoint (o endereço de uma operação da API) fica sempre sob https://api.gsengage.com/api/v1, e você só preenche campos numa tela — sem terminal, sem código.

graph LR
A["Formulário / Planilha"] --> B["Zapier (gatilho)"]
B --> C["Webhooks by Zapier chama a API"]
C --> D["GS Engage cria o lead"]
D --> E["Lead entra na cadência e vai para o SDR"]

Antes de montar qualquer Zap, você precisa da sua apiKey: a chave de cerca de 40 caracteres criada na plataforma em Configurações > Configurações de API.

No GS Engage, a chave viaja na URL, como um parâmetro no formato ?apiKey=SUA_CHAVE (não é um cabeçalho). É prático, mas tem uma consequência importante: a chave aparece em logs de servidor, no histórico do navegador e em qualquer link compartilhado.

Onde guardar a apiKey com segurança no Zapier

Toda chamada ao GS Engage é real: não existe ambiente de teste (sandbox) separado. Por isso, antes de montar um Zap que cria ou altera dados, confirme que a chave responde com uma operação leve e somente leitura: listar os campos personalizados.

Faça esta chamada uma vez (pelo próprio Webhooks by Zapier ou por um curl avulso, se você tiver à mão):

curl "https://api.gsengage.com/api/v1/custom-fields?apiKey=SUA_CHAVE"

Uma resposta 200 com uma lista confirma que a chave está válida. A lista pode vir vazia ([]) se o projeto ainda não tem campos personalizados — e está tudo certo assim.

Agora o principal. O objetivo de negócio: quem preenche o formulário do seu site vira um lead no GS Engage, entra numa cadência e é distribuído a um vendedor — na hora, sem ninguém copiar e colar planilha. O lead nasce marcado como Levantada de Mão, no topo da fila de atividades do SDR.

{
  "name": "{{nome_do_formulario}}",
  "company": "{{empresa_do_formulario}}",
  "emails": [
    { "value": "{{email_do_formulario}}", "label": "Trabalho" }
  ],
  "mobiles": [
    { "value": "{{telefone_do_formulario}}", "label": "Celular" }
  ]
}

{
  "leadId": "{{id_do_lead_do_passo_2}}",
  "responsibleId": "{{id_do_sdr}}"
}

Até aqui, o gatilho estava de fora (o formulário) e o GS Engage recebia dados. Mas dá para inverter: o GS Engage pode avisar o Zapier quando algo acontece — usando um webhook (um aviso automático que ele envia para uma URL sua no exato momento do evento).

Um exemplo clássico: quando uma prospecção é marcada como Ganha, o GS Engage bate na porta do seu Zap, que então registra a venda numa planilha e comemora no Slack.

{
  "name": "Venda ganha para o Zapier",
  "url": "https://hooks.zapier.com/hooks/catch/sua-url",
  "events": ["prospection.won"]
}

Os eventos que você pode ouvir são: prospection.started, prospection.won, prospection.lost, activity.finished, call.started, call.finished e call.transcribed.