Estamos retirando la API local. Consulta nuestro documento Retirada de la API local para obtener más información y aprender a migrar a nuestra API de nube de nueva generación.
Puedes utilizar el extremo /messages para enviar plantillas de mensajes a tus clientes. Una plantilla de mensaje puede basarse en texto o en contenido multimedia o bien ser interactiva.
Para obtener más información sobre las plantillas de mensajes, consulta Mensajes, Mensajes iniciados por la empresa.
Asegúrate de haber completado las acciones que se indican en la documentación Mensajes: requisitos previos.
Las plantillas de mensajes se crean en el administrador de WhatsApp, que forma parte de la cuenta de WhatsApp de Facebook Business Manager. Las plantillas de mensajes se revisarán para garantizar que no infringen las políticas de WhatsApp. Tras la aprobación, tu empresa tendrá su propio espacio de nombres, en el que residirán las plantillas de mensajes.
Para crear una plantilla de mensaje, debes tener lo siguiente:
Al crear una plantilla de mensaje, puedes hacer clic en el botón Añadir muestra para añadir una plantilla de ejemplo. De este modo, durante el proceso de revisión y aprobación podemos comprender el tipo de mensaje que planeas enviar. Asegúrate de que sean ejemplos y no incluyas información personal ni confidencial.
Consulta la documentación Crear plantillas de mensaje para la cuenta de la API de WhatsApp Business para obtener pasos más detallados sobre cómo crear plantillas de mensaje.
Creación de un mensaje de bienvenida en el que el nombre de la plantilla de mensaje sea welcome y el mensaje sea el siguiente:
"Welcome {{1}}. We look forward to serving you on WhatsApp." Creación de un mensaje de confirmación de pedido en el que el nombre de la plantilla de mensaje sea order_confirmation y el mensaje sea el siguiente:
"Your order {{1}} for a total of {{2}} is confirmed. The expected delivery is {{3}}." WhatsApp no realiza ninguna traducción para tu empresa. Debes introducir todas las traducciones de plantillas de mensaje con el mismo formato que se describe aquí. El nombre del elemento es el mismo para todas las traducciones. Consulta los siguientes artículos para obtener más información:
POST a /messagesCuando tengas tu plantilla, puedes enviarla a los clientes mediante el objeto template:
POST /v1/messages
{
"to": "recipient_wa_id",
"type": "template",
"template": {
"namespace": "your-namespace",
"name": "your-template-name",
"language": {
"code": "your-language-and-locale-code",
"policy": "deterministic"
},
"components": [{
"type": "body",
"parameters": [
{
"type": "text",
"text": "your-text-string"
},
{
"type": "currency",
"currency": {
"fallback_value": "$100.99",
"code": "USD",
"amount_1000": 100990
}
},
{
"type": "date_time",
"date_time" : {
"fallback_value": "February 25, 1977",
"day_of_week": 5,
"day_of_month": 25,
"year": 1977,
"month": 2,
"hour": 15,
"minute": 33
}
},
{
"type": "date_time",
"date_time" : {
"fallback_value": "February 25, 1977",
"timestamp": 1485470276
}
}
]
}]
}
}
Solo se admiten los tipos de botones URL, QUICK_REPLY y PHONE_NUMBER.
Si una plantilla tiene un tipo de botón que no figura en esta lista, la API devolverá un error.
Una respuesta correcta incluye un objeto messages con un valor de id.
{
"messages": [{
"id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
}]
}
Una respuesta incorrecta contiene un objeto de error que incluye una cadena de error, un código de error y otros datos. Consulta Códigos de error y de estado para obtener más información.
A partir del 6 de febrero de 2024, los límites de mensajes de plantilla de marketing por usuario se aplican a los mensajes de plantilla enviados a un número reducido de usuarios de WhatsApp de la India, pero se aplicarán a todos los usuarios de WhatsApp con un número de teléfono indio el 13 de febrero de 2024.
Estamos implementando nuevos enfoques, empezando por los consumidores de la India, que crean experiencias de usuario de alta calidad y maximizan la interacción con los mensajes de plantilla de marketing. Esto puede incluir la limitación del número de mensajes de plantilla de marketing que una persona recibe de cualquier empresa en un periodo determinado de tiempo, comenzando con un número reducido de conversaciones que tienen menos probabilidades de que se lean. Ten en cuenta que el límite se determina en función del número de mensajes de plantilla de marketing que esa persona ya ha recibido de cualquier empresa y no está relacionado con tu empresa en concreto.
El límite solo se aplica a los mensajes de plantilla de marketing que normalmente abrirían una nueva conversación de marketing. Si una conversación de marketing ya está abierta entre ti y un usuario de WhatsApp, los mensajes de plantilla de marketing que se envíen al usuario no se verán afectados.
Si un mensaje de plantilla de marketing no se entrega a un usuario determinado debido al límite, la API local devolverá el código de error 1026. Sin embargo, debes tener en cuenta que este código de error abarca una amplia variedad de problemas que pueden tener como resultado que un mensaje no se entregue y, por motivos de privacidad, no revelaremos si de hecho el mensaje no se entregó debido al límite. Consulta “¿Por qué no tengo una frecuencia de entrega del 100 %?” en Preguntas frecuentes para obtener más información.
Si recibes uno de estos códigos de error y sospechas que se debe al límite, evita de inmediato volver a enviar el mensaje de plantilla, ya que solo dará como resultado otra respuesta de error. En lugar de eso, vuelve a intentar aumentar los incrementos de tiempo más largos hasta que el mensaje se entregue, ya que el límite puede estar vigente durante diferentes periodos de tiempo.
Seguiremos mejorando nuestro enfoque y agradecemos tu colaboración mientras invertimos en hacer que WhatsApp sea la mejor experiencia posible para tu empresa y tus clientes.