Ir al contenido

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

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
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"
}'

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

Cada código tiene su explicación en Errores.