Integrações
DataPlannedExportação

Read API & Webhooks

Seus dados, legíveis por você. Não presos atrás de um dashboard.

Agências cuidam de muitos tenants e precisam de acesso programático: feeds de status de conversão, agregados por campanha, recibos de entrega. Tokens com escopo retornam agregados por tenant, webhooks empurram mudanças de status em tempo real, e todo payload pode ser reproduzido pelo id de entrega.

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.

Relatório por screenshot não escala

Sem acesso de leitura, cada relatório de cliente significa logar em outro dashboard. Dado que você pagou para gerar não deveria exigir exportação manual para ser útil.

Um contrato determinístico para todos os tenants que você atende

Leia agregados agrupados por campanha ou janela, receba webhooks quando resultados confirmam ou retraem, e alimente seu BI e relatórios de cliente pela mesma fonte que as plataformas de anúncio veem.

O que você pode ler

conversion_status_feedcampaign_aggregatesdelivery_receiptstenant_event_stream

Como os dados fluem

  1. Agency connects one workspace covering all its tenants
  2. Scoped read token returns aggregates, never raw patient data
  3. Webhooks push conversion status changes as they happen
  4. Dashboards and reports read from one deterministic contract
  5. Every payload is idempotent and replayable by delivery id

Como a conexão funciona

  1. Crie um token de leitura com escopo no workspace (só agregados, sem registros brutos).

  2. Assine os webhooks conversion.delivered, conversion.failed, outcome.confirmed e outcome.retracted.

  3. Consulte ou escute; todo evento carrega um id de entrega reproduzível.

  4. Aponte seus dashboards para os mesmos números que as plataformas de anúncio recebem.

Mapeamento de eventos

FromApointoo
GET /v1/conversions?tenant=&window=conversion_status_feed
GET /v1/aggregates?groupBy=campaigncampaign_aggregates
Webhook: conversion.delivered / conversion.faileddelivery_receipts
Webhook: outcome.confirmed / outcome.retractedtenant_event_stream

Perguntas frequentes

Seus dados, legíveis por você. Não presos atrás de um dashboard.

Não. A superfície de leitura serve agregados e status por design. Registros clínicos ficam no dashboard do tenant sob os controles de acesso existentes.