Actualizar las plantillas de correo electrónico existentes
/templates/email/update
Utiliza este punto final para actualizar plantillas de correo electrónico en el panel Braze.
Puedes acceder a la página email_template_id de una plantilla de correo electrónico navegando hasta ella en la página Plantillas y medios. El punto final Crear plantilla de correo electrónico también devolverá una referencia email_template_id.
Todos los campos que no sean email_template_id son opcionales, pero debes especificar al menos un campo para actualizarlo.
Requisitos previos
Para utilizar este punto final, necesitarás una clave de API con el permiso templates.email.update.
Límite de velocidad
Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto final, como se documenta en Límites de velocidad de la API.
Cuerpo de la solicitud
1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
1
2
3
4
5
6
7
8
9
10
{
"email_template_id": (required, string) Your email template's API Identifier,
"template_name": (optional, string) The name of your email template,
"subject": (optional, string) The email template subject line,
"body": (optional, string) The email template body that may include HTML,
"plaintext_body": (optional, string) A plaintext version of the email template body,
"preheader": (optional, string) The email preheader used to generate previews in some clients,
"tags": (optional, array of Strings) Tags must already exist,
"should_inline_css": (optional, Boolean) If `true`, the `inline_css` feature will be applied to the template.
}
Parámetros de la solicitud
| Parámetro | Obligatoria | Tipo de datos | Descripción |
|---|---|---|---|
email_template_id |
Obligatoria | Cadena | El identificador API de tu plantilla de correo electrónico. |
template_name |
Opcional | Cadena | Nombre de tu plantilla de correo electrónico. |
subject |
Opcional | Cadena | Línea del asunto de la plantilla de correo electrónico. |
body |
Opcional | Cadena | Cuerpo de la plantilla de correo electrónico que puede incluir HTML. |
plaintext_body |
Opcional | Cadena | Una versión en texto plano del cuerpo de la plantilla de correo electrónico. |
preheader |
Opcional | Cadena | Preencabezado de correo electrónico utilizado para generar vistas previas en algunos clientes. |
tags |
Opcional | Cadena | Las etiquetas ya deben existir. |
should_inline_css |
Opcional | Booleano | Habilita o deshabilita la característica inline_css por plantilla. Si no se proporciona, Braze utilizará la configuración predeterminada para el AppGroup. Se espera una de true o false. |
Ejemplo de solicitud
1
2
3
4
5
6
7
8
9
10
11
12
curl --location --request POST 'https://rest.iad-01.braze.com/templates/email/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
"email_template_id": "email_template_id",
"template_name": "Weekly Newsletter",
"subject": "This Week'\''s Styles",
"body": "Check out this week'\''s digital lookbook to inspire your outfits. Take a look at https://www.braze.com/",
"plaintext_body": "This is the updated text within my email body and here is a link to https://www.braze.com/.",
"preheader": "We want you to have the best looks this summer",
"tags": ["Tag1", "Tag2"]
}'
Solución de problemas
La siguiente tabla enumera los posibles errores devueltos y sus pasos asociados para la solución de problemas, si procede.
| Error | Solución de problemas |
|---|---|
| El nombre de la plantilla es obligatorio. | Introduce un nombre para la plantilla. |
| Las etiquetas deben ser una matriz | Las etiquetas deben formatearse como una matriz de cadenas, por ejemplo ["marketing", "promotional", "transactional"]. |
| Todas las etiquetas deben ser cadenas | Asegúrate de que tus etiquetas estén entre comillas (""). |
| No se han encontrado algunas etiquetas | Para añadir una etiqueta al crear una plantilla de correo electrónico, la etiqueta debe existir ya en Braze. |
Valor no válido para should_inline_css. Se esperaba una de true o false |
Este parámetro solo acepta valores booleanos (verdadero o falso). Asegúrate de que el valor de should_inline_css no está encapsulado entre comillas (""), lo que hace que el valor se envíe como una cadena. |
Editar esta página en GitHub