Conversions API
Qualquer sistema que sabe o resultado agora pode dizer ao Apointoo.
Os adaptadores nativos cobrem as grandes plataformas de agendamento. A API de Conversões cobre todo o resto: o CRM próprio, a planilha interna, o sistema caseiro do cliente. Um endpoint autenticado recebe identidade, identificadores de atribuição e valor. O que volta para as contas de anúncio é o mesmo resultado verificado que todo adaptador do Apointoo produz.
Se o resultado vive fora de um adaptador, ele nunca chega ao anúncio
Clínicas usam sistemas que nenhum conector cobre. O agendamento acontece, a plataforma de anúncios nunca fica sabendo, e a campanha continua otimizando por cliques.
Um POST por resultado, um livro-razão para todos
Envie o resultado quando ele acontece, com sua própria chave de idempotência. O Apointoo liga o resultado à visita original, aplica as regras de consentimento e entrega ao Google Ads como uma integração nativa entregaria. Retrações funcionam igual, no sentido contrário.
O que qualquer sistema pode enviar
Como os dados fluem
- Your system confirms the outcome (booking, sale, stage change)
- One authenticated POST carries identity + attribution ids + value
- Apointoo matches the visit, dedupes on your idempotency key
- The outcome enters the same ledger as native adapters
- Ad platforms receive it under the same consent rules
Como a conexão funciona
Solicite um token de ingestão com escopo no seu workspace.
Faça POST de cada resultado com identidade, identificadores de atribuição, valor e sua chave de idempotência.
Reenviar a mesma chave retorna o mesmo resultado; nada duplica.
Reembolsos e cancelamentos entram como eventos de retração no mesmo registro.
Identificadores de atribuição
Mapeamento de eventos
| From | Apointoo |
|---|---|
| POST /v1/conversions { type: lead } | lead_captured |
| POST /v1/conversions { type: appointment_booked } | appointment_booked |
| POST /v1/conversions { type: appointment_attended } | appointment_attended |
| POST /v1/conversions { type: sale, value, currency } | sale_paid |
| POST /v1/conversions { type: refund } | refund_retraction |
Perguntas frequentes
Qualquer sistema que sabe o resultado agora pode dizer ao Apointoo.