PerpetuusPerpetuus Developers

Meta Lead Ads (BETA)

Integrações Lead Ads, OAuth e roteamento de formulários para boards.

BETA — API avançada. Create/update podem inscrever webhooks na página Facebook. Tokens são sensíveis. Callback OAuth e webhooks inbound não fazem parte do contrato público.

Fluxo

  1. POST /meta-lead/facebook-oauth/start → redirecionar o usuário
  2. POST /meta-lead/facebook-oauth/complete
  3. POST /meta-lead-integrations (ou use a integração criada no OAuth)
  4. POST /meta-lead-form-routes mapeando form → board + fieldMapping

Form route (exemplo)

{
  "data": {
    "name": "Form Contato → Funil",
    "metaLeadIntegrationDocumentId": "mli1a2b3c",
    "targetBoardDocumentId": "bd1a2b3c",
    "facebookFormId": "120000",
    "fieldMapping": {
      "mappings": [
        { "source": "email", "target": "email" },
        { "source": "full_name", "target": "name" }
      ]
    }
  }
}

Referência: API Reference → Meta Lead Ads.

On this page