API de Conversões

Como enviar resultados de qualquer sistema para o Apointoo por um endpoint autenticado.

API de Conversões (especificação)

Status: planejado. Esta página é a especificação de trabalho. O produto é construído depois que a demanda de cliques valida a página. Entre na lista de acesso antecipado na página do produto.

O que resolve

Sistemas de agendamento sem adaptador nativo nunca levam o resultado ao Google Ads. A API de Conversões recebe esse resultado de qualquer sistema que saiba quando a venda ou o agendamento aconteceu.

Contrato (v0, simulado)

POST /v1/conversions
Authorization: Bearer <ingest-token>
Content-Type: application/json

{
  "type": "appointment_booked",        // lead | appointment_booked | appointment_attended | sale | refund
  "idempotency_key": "sistema-x-12345",
  "contact": { "phone": "+5561999990000", "email": "maria@exemplo.com" },
  "attribution": { "gclid": "...", "utm_source": "google", "utm_campaign": "meta-agosto" },
  "value": 180.00,
  "currency": "EUR",
  "occurred_at": "2026-08-24T14:30:00Z"
}

Reenviar a mesma idempotency_key retorna o mesmo resultado; nada duplica.
Sem consentimento, identificadores de clique são removidos antes da entrega ao anúncio.
refund vira retração no mesmo registro.

Regras de privacidade

Identidade se limita aos campos de correspondência (telefone, e-mail). Detalhe clínico não pertence ao payload.

Esta página foi útil?

Leitura complementar