Actualizar configuración de plantilla

Actualiza una configuración de plantilla existente, permitiendo modificar el nombre, el tipo, el contenido, los países de envío y la información de la firma. Tras la actualización, la plantilla vuelve al estado "Pendiente de revisión".

URL de solicitud

PUT https://smsapi.engagelab.com/v1/template-configs/:templateId

Validación de la llamada

Consulta Validación de la llamada para saber cómo realizar la autenticación de la API.

Ejemplo de solicitud

Encabezado de la solicitud

              
              PUT /v1/template-configs/123456789  HTTP/1.1
Content-Type: application/json
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

            

Cuerpo de la solicitud

              
              {
  "template_name": "Plantilla de notificación de pedido",
  "template_type": "utility",
  "template_content": "Su pedido {order_no} ha sido enviado y se espera que se entregue antes de {delivery_time}",
  "country_codes": "CN,US",
  "add_signature": true,
  "sign_id": "987654321",
  "sign_position": 2
}

            

Parámetros de solicitud

Parámetros de ruta

Parámetros del cuerpo de la solicitud

Parámetros de respuesta

Respuesta correcta

El código de estado HTTP es 200 y el cuerpo de la respuesta contiene los siguientes campos:

Ejemplo correcto

              
              {
  "code": 0,
  "message": "success"
}

            

Respuesta con error

El código de estado HTTP es 4xx/5xx y el cuerpo de la respuesta contiene los siguientes campos:

Ejemplo de error

              
              {
  "code": 400,
  "message": "can not update pending status template"
}

            

Códigos de error

Mensajes de error comunes:

• invalid templateId: formato del ID de plantilla incorrecto
• template config not exist: la configuración de plantilla no existe
• can not update pending status template: no se puede actualizar una plantilla en estado pendiente de revisión
• there are pending or running plans using current template, can not update: hay planes pendientes de envío o en ejecución que usan esta plantilla, no se puede actualizar
• sign config not exist: la configuración de firma no existe
• sign status is not approved, can not use: la firma no está aprobada y no se puede usar

Consideraciones

1. No se puede actualizar una plantilla en estado pendiente de revisión
2. Si hay planes de mensajes pendientes de envío o en ejecución que usan esta plantilla, no se puede actualizar
3. Tras la actualización, la plantilla vuelve al estado "Pendiente de revisión" (status=1)
4. Si se añade una firma, esta debe estar en estado aprobado
5. El contenido de la plantilla no puede contener caracteres prohibidos: 【, 】, 、, 测试, test, [, ]
6. Tanto el ID de la plantilla como el de la firma son números de tipo cadena

Apéndice

Estado de la configuración de plantilla (status)

Tipo de plantilla (template_type)

Posición de la firma (sign_position)