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
/forms

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).

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de consulta

q?|
Largolength <= 191
status?|
Valor en"draft""published""deprecated"null
device_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?|
Rango1 <= value
perPage?integer
Rango1 <= value <= 100
Por defecto25

Cuerpo de la respuesta

OK

application/json
  1. 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  }}

Esto es lo que se copia para tu IA

Cargando…