Beta privada · apertura 23 de diciembre
Crea una plantilla
POST /v1/conecta/plantillas
Crea una plantilla y la manda a revisión. Te avisamos con el evento plantilla.estado.
| Dato | Valor |
|---|---|
| Permiso | conecta:administrar |
| Cobro | No cobra. |
Idempotency-Key |
Opcional |
| Herramienta MCP | plantilla_crear (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
Idempotency-Key |
header | No | string | Identifica una operación para que repetirla no la duplique. Si repites la petición con la misma clave y el mismo cuerpo, recibes la misma respuesta; con otro cuerpo, idempotencia_en_conflicto. Se guarda 24 horas. |
X-Request-Id |
header | No | string | Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte. |
application/json, obligatorio. Los campos anidados van con punto y los de listas con []. No se aceptan campos desconocidos.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
conexion_id |
string | Sí | Identificador que empieza con con_. |
nombre |
string | Sí | |
idioma |
string | Sí | Código de idioma, por ejemplo es o es_PE. |
categoria |
“utilidad” | “marketing” | “autenticacion” | Sí | Nunca uses plantillas para cobro de deudas: Meta no lo permite. |
cuerpo |
string | Sí | Texto con variables {{1}}, {{2}}… |
encabezado |
string | No | |
pie |
string | No | |
botones |
object[] | No | |
botones[].tipo |
“respuesta_rapida” | “url” | “telefono” | Sí | |
botones[].texto |
string | Sí | |
botones[].url |
string (uri) | No | URL pública con https (sin IP literal, localhost, dominios internos ni usuario y clave). |
botones[].telefono |
string | No | Teléfono en formato E.164, sin espacios. |
ejemplos |
string[] | No | Valores de ejemplo para la revisión de Meta. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl -X POST "https://api-sandbox.opennexum.com/v1/conecta/plantillas" \ -H "Authorization: Bearer onx_test_…" \ -H "Content-Type: application/json" \ -d '{ "conexion_id": "con_8f2c1a7d9e", "nombre": "texto", "idioma": "texto", "categoria": "utilidad", "cuerpo": "texto"}'Respuestas
Sección titulada «Respuestas»Plantilla creada, pendiente de revisión.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id |
string | Sí | Identificador que empieza con plt_. |
conexion_id |
string | Sí | Identificador que empieza con con_. |
nombre |
string | Sí | |
idioma |
string | Sí | |
categoria |
“utilidad” | “marketing” | “autenticacion” | Sí | |
estado |
“pendiente” | “aprobada” | “rechazada” | “pausada” | “deshabilitada” | Sí | |
encabezado |
string | null | Sí | |
cuerpo |
string | Sí | |
pie |
string | null | Sí | |
botones |
object[] | Sí | |
botones[].tipo |
“respuesta_rapida” | “url” | “telefono” | Sí | |
botones[].texto |
string | Sí | |
variables |
integer | Sí | Cuántas variables espera el cuerpo. |
motivo_rechazo |
string | null | Sí | |
creada_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
actualizada_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 404
no_encontrado - 409
idempotencia_en_conflicto - 409
solicitud_en_curso - 409
ya_registrado - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 502
servicio_externo_no_disponible - 503
no_disponible