Pular para o conteúdo

GET /v1/ads/pages/{pageId}/forms

GET
/v1/ads/pages/{pageId}/forms
curl --request GET \
--url https://seu-endereco-da-api/v1/ads/pages/example/forms \
--header 'Authorization: Bearer <token>'

Permissão que a Chave de acesso precisa: Ler Meta Ads (ads:read).

pageId
required
string
Media typeapplication/json
object
pageId
required
string
forms
required
Array<object>
object
id
required
string
name
required
string
status
required
string
Allowed values: ACTIVE ARCHIVED DELETED DRAFT
createdTime
required
string
nullable
questions
required
Array<object>
object
key
required
string
label
required
string
type
required
string
leadsCountMeta
required

Leads_count da Meta

number
nullable
leads7d
required
number
leads30d
required
number
leadsTotal
required
number
pendingLeads
required
number
lastLeadAt
required
string format: date-time
nullable
routing
required
object
kind
required
string
Allowed values: flow none
flows
required
Array<object>
object
id
required
string
name
required
string
status
required
string
scope
required
string
Allowed values: form page any
formId
required
string
nullable
formName
required
string
nullable
channel
required

Null quando o gatilho aponta para canal apagado ou de outro provider

object
name
required

O nome que o cliente deu ao canal na plataforma

string
provider
required
string
status
required
string
coexistence
required
boolean
phoneNumber
required

O numero ou @ da conta no provedor

string
nullable
accountName
required

O nome da conta no provedor: o verificado da Meta, ou o do aparelho no canal lite

string
nullable
removed
required

O canal foi apagado; a conversa continua descrevendo por onde ela aconteceu

boolean
id
required
string
usable
required

True quando o flow-engine aceita este canal para o próximo lead: WhatsApp, conectado e não apagado

boolean
testingToolUrl
required
string
fieldMappings
required

Perguntas ligadas a campos do contato

Array<object>
object
questionKey
required
string
fieldKey
required

Campo do contato que recebe a resposta

string
nullable
tagId
required

Etiqueta aplicada a quem responde a pergunta

string
nullable
fillOnlyEmpty
required

Verdadeiro: só preenche o campo quando ele está vazio; falso: atualiza sempre

boolean

Example

{
"forms": [
{
"status": "ACTIVE",
"routing": {
"kind": "flow",
"flows": [
{
"scope": "form"
}
]
}
}
]
}