Referencia (endpoints)Atender una conversación
Ver tus formularios
Úsalo para encontrar el formulario que vas a mandar: su family_id es el form_id que pides al mandarlo (el id es el de una versión).
GET
Permiso requerido: Contactos y conversaciones → Ver
Lista los formularios de tu cuenta, uno por formulario aunque tenga varias versiones; de cada uno ves la versión que usas hoy (la publicada o, si no hay, la más nueva). El id de cada fila es el de esa versión y family_id es el del formulario. Filtra con q (parte del nombre), status (draft, published o deprecated) y device_id (un número de tu cuenta; si no es WhatsApp Cloud responde 422 NUMBER_NOT_ELIGIBLE). Pagina con perPage (1 a 100, 25 por defecto).
httpheader
AuthorizationBearer <clave>q?|Largo
length <= 191status?|Valor en
"draft""published""deprecated"nulldevice_id?|Id opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.
Patrón
^dev_[A-Za-z0-9]{23}$page?|Rango
1 <= valueperPage?integerRango
1 <= value <= 100Por defecto
25OK
application/json- response
data*array<>links*meta*curl -X GET "https://example.com/forms"{ "data": [ { "id": "frv_Ath9bJ3RpAYPhnX0EfcLtHJ", "family_id": "frm_AyJUGabeXUAk9dbBuWegw4B", "name": "string", "label": "string", "category": "string", "status": "string", "version": 0, "definition": [ null ], "fields": [ null ], "mapping": [ null ], "tag_rules": [ null ], "has_endpoint": true, "first_screen": "string", "first_screen_dynamic": true, "lint_errors_count": 0, "draft_id": "frv_Ath9bJ3RpAYPhnX0EfcLtHJ", "draft_version": 0, "sends": 0, "responses": 0, "meta_flow_id": "string", "flow_json": [ null ], "validation_errors": [ null ], "published_at": "string", "updated_at": "string" } ], "links": { "first": "string", "last": "string", "prev": "string", "next": "string" }, "meta": { "current_page": 0, "from": 0, "last_page": 0, "links": [ { "url": "string", "label": "string", "active": true } ], "path": "string", "per_page": 0, "to": 0, "total": 0 }}