Zapier, Make e outras ferramentas

Qualquer ferramenta que faça requisições HTTP consegue conversar com a Perpetuus API. Nas plataformas de automação, procure pelo módulo genérico de HTTP:

Configuração base (vale para todas)

Em todo request, configure:

• URL: https://api.perpetuus.com.br/api/... (veja os endpoints na API Reference)
• Headers:
  • Authorization: Bearer SEU_TOKEN — como gerar
  • x-tenant-id: slug da sua organização (ex.: acme)
  • Content-Type: application/json (para POST/PUT)

Receita: novo lead do anúncio → card no board

1. Gatilho: novo lead na sua ferramenta de origem (formulário, planilha, anúncio).
2. Ação: HTTP POST https://api.perpetuus.com.br/api/boards/SEU_BOARD_ID/cards
3. Corpo:

{
  "data": {
    "fields": {
      "name": "{{nome_do_lead}}",
      "email": "{{email}}",
      "phone": "{{telefone}}"
    },
    "tags": ["origem-anuncio"]
  }
}

Receita: registrar atividade quando o cliente responder

1. Gatilho: nova resposta/e-mail na sua ferramenta.
2. Ação: HTTP POST https://api.perpetuus.com.br/api/contact-activities/note

{
  "contactId": "{{documentId_do_contato}}",
  "note": "Cliente respondeu: {{resumo}}"
}

Receita: planilha semanal com os cards do funil

1. Gatilho: agendamento (ex.: toda segunda às 8h).
2. Ação: HTTP GET https://api.perpetuus.com.br/api/boards/SEU_BOARD_ID/cards?pagination[pageSize]=100
3. Ação: escrever as linhas de data[] na planilha. Cada card traz o objeto fields pronto ({ "email": "...", "valor_orcamento": 25000 }) — sem parsing extra.

Dicas

• IDs: descubra o documentId do board com GET /api/boards (ou copie da URL do app).
• Teste primeiro no API Reference, que mostra exemplos de resposta reais de cada endpoint.
• Para volumes grandes (importação de contatos), prefira os endpoints de operações em massa.