Integrações
DataProductionImportação de dados

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

lead_capturedappointment_bookedappointment_attendedsale_paidrefund_retraction

Como os dados fluem

  1. Your system confirms the outcome (booking, sale, stage change)
  2. One authenticated POST carries identity + attribution ids + value
  3. Apointoo matches the visit, dedupes on your idempotency key
  4. The outcome enters the same ledger as native adapters
  5. Ad platforms receive it under the same consent rules

Como a conexão funciona

  1. Solicite um token de ingestão com escopo no seu workspace.

  2. Faça POST de cada resultado com identidade, identificadores de atribuição, valor e sua chave de idempotência.

  3. Reenviar a mesma chave retorna o mesmo resultado; nada duplica.

  4. Reembolsos e cancelamentos entram como eventos de retração no mesmo registro.

Identificadores de atribuição

gclidgbraidwbraidfbclidutm_sourceutm_campaign

Mapeamento de eventos

FromApointoo
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.

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.