Beta privada · apertura 23 de diciembre
Lista plantillas
GET /v1/conecta/plantillas
Plantillas de mensaje por conexión, con su estado de revisión.
| Dato | Valor |
|---|---|
| Permiso | conecta:leer |
| Cobro | No cobra. |
Idempotency-Key |
No aplica |
| Herramienta MCP | plantilla_listar (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
cursor |
query | No | string | Cursor opaco que devolvió la página anterior en siguiente_cursor. |
limite |
query | No | integer | Cuántos elementos traer (1 a 100; por defecto 20). |
conexion_id |
query | No | string | Identificador que empieza con con_. |
estado |
query | No | string | |
X-Request-Id |
header | No | string | Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl "https://api-sandbox.opennexum.com/v1/conecta/plantillas" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Página de plantillas.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
elementos |
object[] | Sí | |
elementos[].id |
string | Sí | Identificador que empieza con plt_. |
elementos[].conexion_id |
string | Sí | Identificador que empieza con con_. |
elementos[].nombre |
string | Sí | |
elementos[].idioma |
string | Sí | |
elementos[].categoria |
“utilidad” | “marketing” | “autenticacion” | Sí | |
elementos[].estado |
“pendiente” | “aprobada” | “rechazada” | “pausada” | “deshabilitada” | Sí | |
elementos[].encabezado |
string | null | Sí | |
elementos[].cuerpo |
string | Sí | |
elementos[].pie |
string | null | Sí | |
elementos[].botones |
object[] | Sí | |
elementos[].botones[].tipo |
“respuesta_rapida” | “url” | “telefono” | Sí | |
elementos[].botones[].texto |
string | Sí | |
elementos[].variables |
integer | Sí | Cuántas variables espera el cuerpo. |
elementos[].motivo_rechazo |
string | null | Sí | |
elementos[].creada_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
elementos[].actualizada_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
siguiente_cursor |
string | null | Sí | Pásalo como cursor para la página siguiente; null si ya no hay más. |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible