Conversions API
Qualquer sistema que sabe o resultado agora pode dizer ao Apointo.
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 Apointo produz.
Páginas marcadas como Planejada são especificações completas escritas antes de o conector existir. Elas validam a demanda. Conectores com logs reais de entrega estão marcados como Produção ou Beta.
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 Apointo 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.
- 01Your system confirms the outcome (booking, sale, stage change)
- 02One authenticated POST carries identity + attribution ids + value
- 03Apointo matches the visit, dedupes on your idempotency key
- 04The outcome enters the same ledger as native adapters
- 05Ad platforms receive it under the same consent rules
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.
| From | Apointo |
|---|---|
| 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 |
Isso substitui os adaptadores nativos?
Não. Adaptadores continuam sendo o caminho sem código para as plataformas cobertas. A API existe para os sistemas que nunca terão adaptador.
E o consentimento e dados de saúde?
As mesmas regras de consentimento se aplicam: sem consentimento, os identificadores de clique são removidos, e detalhe clínico nunca pertence ao payload. Identidade se limita aos campos de correspondência.
Quando isso sai?
Esta página é a especificação de trabalho. As inscrições de acesso antecipado definem a ordem de construção.