Cada receita abaixo é uma automação completa e testada. Você escolhe a ferramenta no-code (Zapier, Make ou n8n), copia os campos e adapta para o seu processo. Pense em cada uma como um pequeno robô: quando algo acontece (o gatilho), ele executa uma ação no GS Engage ou em outro sistema.

Todas as receitas usam a mesma autenticação. A chave de API (apiKey) é como uma senha que autoriza a automação a falar com o GS Engage.

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

Um retorno 200 (mesmo que seja uma lista vazia []) significa: a chave é válida e você pode seguir para as receitas. Um 401 significa que a chave está ausente ou incorreta.

Persona: você recebe leads por um formulário (site, landing page, evento) e quer que cada um entre automaticamente numa Cadência e seja distribuído a um vendedor (SDR), sem digitação manual.

curl "https://api.gsengage.com/api/v1/routines?apiKey=SUA_CHAVE"

curl -X POST "https://api.gsengage.com/api/v1/routines/{routineId}/lead?apiKey=SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "lead": {
      "name": "Maria Souza",
      "emails": [{ "value": "maria@empresa.com", "label": "Trabalho" }],
      "mobiles": [{ "value": "+5511999998888", "label": "Celular" }]
    },
    "responsibleId": "ID_DO_SDR"
  }'

O que a resposta significa: o lead entra marcado como Levantada de Mão (o cliente pediu contato) e aparece no topo da fila de atividades do vendedor. Ou seja: o SDR abre o app e a primeira tarefa já é falar com esse lead quente.

Persona: toda vez que um negócio é ganho, você quer registrar a venda numa planilha (para o financeiro/BI) e comemorar no canal do time no Slack — automaticamente.

Aqui o gatilho não é um formulário: é o próprio GS Engage avisando você. Isso funciona com webhook (um "aviso automático": o GS Engage faz uma chamada para a sua URL quando o evento acontece).

curl -X POST "https://api.gsengage.com/api/v1/webhooks?apiKey=SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Venda ganha para planilha e Slack",
    "url": "https://hooks.zapier.com/hooks/catch/000000/abcde/",
    "events": ["prospection.won"]
  }'

Cada aviso chega no seguinte envelope (o campo data traz os detalhes da prospecção ganha):

{
  "id": "evt_123",
  "test": false,
  "event": "prospection.won",
  "data": { },
  "retries": 0,
  "manualRetries": 0,
  "createdAt": "2026-07-17T14:03:00.000Z"
}

O que isso entrega ao negócio: o financeiro e o BI param de depender de exportação manual, e o time vê cada vitória no Slack em tempo real — sem ninguém copiar e colar nada.

Persona: seus leads nascem no RD Station (marketing) e você quer que eles apareçam automaticamente no GS Engage para o time comercial trabalhar.

curl -X POST "https://api.gsengage.com/api/v1/leads?apiKey=SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "João Pereira",
    "company": "ACME Ltda",
    "emails": [{ "value": "joao@acme.com", "label": "Trabalho" }],
    "mobiles": [{ "value": "+5521988887777", "label": "Celular" }]
  }'

O que a resposta significa: o retorno traz o id do novo lead. A partir daí, ele já existe no GS Engage e pode ser distribuído, colocado em cadência ou trabalhado normalmente.

Quando algo dá errado

As mensagens de erro do GS Engage já vêm em português e podem ser reaproveitadas direto na sua automação.