Crear un formulario
Úsalo para empezar un formulario de WhatsApp en uno de tus números oficiales, a partir de un modelo: queda como borrador y después le guardas su contenido.
Permiso requerido: Contactos y conversaciones → Editar
Crea un formulario nuevo como borrador de tu cuenta. Envía template_key (una de las key de GET /forms/templates; blank empieza vacío), device_id (un número de WhatsApp Cloud de tu cuenta) y, si quieres, device_ids con otros números donde también vivirá. Responde 201 con la versión (id), su family_id, lint y numbers. Si un número no es de tu cuenta o no es WhatsApp Cloud responde 422 NUMBER_NOT_ELIGIBLE.
httpAuthorizationBearer <clave>application/json- body
device_id*stringId opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.
^dev_[A-Za-z0-9]{23}$device_ids?array<>items <= 50template_key*stringCreated
application/json- response
data*lint*array<unknown>numbers*array<any>1 <= items <= 1curl -X POST "https://example.com/forms" \ -H "Content-Type: application/json" \ -d '{ "device_id": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX", "template_key": "string" }'{ "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" }, "lint": [ null ], "numbers": [ { "device_id": null, "primary": true, "status": "string", "error": "string" } ]}Ver los modelos de formulario GET
Sirve para ver los modelos con los que puedes empezar un formulario de WhatsApp (uno en blanco y otros listos) y elegir la key que pides al crearlo.
Ver un formulario GET
Sirve para ver una versión de un formulario con su contenido, lo que falta corregir antes de publicarla, sus versiones y sus números.