# Plantillas de utilidad de WhatsApp Una plantilla de utilidad da seguimiento a algo que el destinatario ya hizo: un pedido, un pago, una reserva, un inicio de sesión. El catálogo de Bird incluye ocho, entre ellas `bird_signin_alert` y `bird_delivery_update`. Toma la categoría de un slug de la lista de plantillas, no de su nombre: `bird_signin_alert` parece una plantilla de autenticación, pero no lo es; es de utilidad. ## Antes de enviar Elige una plantilla del catálogo gestionado o crea una en tu cuenta de negocio conectada. Enviar las plantillas del catálogo de Bird no requiere verificación de tu parte, igual que con autenticación. Crear una plantilla de utilidad propia tampoco la necesita: a diferencia de autenticación, la verificación de negocio de Meta nunca aplica a utilidad, así que puedes crear y editar plantillas de utilidad en un espacio de trabajo no verificado. Consulta [Verificación de negocio de WhatsApp](/docs/knowledge-base/whatsapp/business-verification) para saber qué desbloquea la verificación en otros casos. `to` puede ser un número de teléfono E.164 o un ID de usuario con alcance de negocio. Una plantilla de utilidad no lleva botón OTP, por lo que no exige el destinatario exclusivamente por número de teléfono que sí requiere autenticación. Cada plantilla de utilidad del catálogo gestionado está registrada solo en `en`, con `on_missing_language: fail`. Solicitar un idioma que el catálogo no tiene hace fallar el envío en lugar de recurrir al inglés o a cualquier otro idioma. ## Enviar una plantilla de utilidad `POST /v1/whatsapp/messages` con un objeto `template` que nombra un slug del catálogo: **TypeScript** ```typescript const msg = await bird.whatsapp.send({ to: "+16505551234", template: { slug: "bird_order_confirmation", language: "en", components: [ { type: "body", parameters: [ { type: "text", name: "ref", text: "A1B2C3D4" }, { type: "text", name: "amount", text: "USD 49.99" }, ], }, ], }, }); console.log(msg.id, msg.status); ``` Examples: [TypeScript](/es-es/documentacion/guides/whatsapp/templates/utility.ts.md) · [Python](/es-es/documentacion/guides/whatsapp/templates/utility.py.md) · [Go](/es-es/documentacion/guides/whatsapp/templates/utility.go.md) · [PHP](/es-es/documentacion/guides/whatsapp/templates/utility.php.md) · [CLI](/es-es/documentacion/guides/whatsapp/templates/utility.cli.md) · [MCP](/es-es/documentacion/guides/whatsapp/templates/utility.mcp.md) · [cURL](/es-es/documentacion/guides/whatsapp/templates/utility.curl.md) Como con cualquier plantilla gestionada, omite `from`: Bird elige el número de envío según la categoría y la región, y establecerlo devuelve `422` [`E15018`](/docs/api/errors/E15018) `WhatsAppSenderNotAllowed`. Crear tu propia plantilla de utilidad y enviarla funciona igual que cualquier envío con plantilla propia; consulta [Enviar con una plantilla](/docs/guides/whatsapp/templates#sending-with-a-template) para el contrato general. ## Completar las variables Los parámetros de utilidad son nombrados, al revés del código posicional único de autenticación. Cada parámetro lleva un `name`, y el orden de un parámetro nombrado en el arreglo no tiene significado. Envía una entrada `components` por cada bloque que realmente tenga un marcador de posición; un cuerpo sin variables no lleva entrada `components` en absoluto. Un botón de URL es la única excepción: su variable siempre es posicional `{{1}}`, y el envío lleva solo el valor en lugar de una dirección completa: ```json { "type": "button", "parameters": [{ "type": "text", "text": "A-4192" }] } ``` Para las reglas compartidas sobre componentes, `sub_type`, y cómo los `components` de un envío se alinean con los marcadores de posición declarados en una plantilla, consulta [Enviar con una plantilla](/docs/guides/whatsapp/templates#sending-with-a-template) y [Componentes y parámetros](/docs/guides/whatsapp/sending-whatsapp#components-and-parameters). ## Costo Una plantilla de utilidad entregada dentro de una ventana abierta de servicio al cliente puede calificar para la tarifa gratuita de Meta. La tarifa de envío de Bird se cobra durante el procesamiento del mensaje, antes del envío. Un callback posterior de entrega o lectura determina si se aplica una tarifa de Meta. Revisa ambos componentes al estimar el total. Consulta [Costo y facturación](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) para saber cuándo se cobra un envío, y [Precios de WhatsApp](/products/whatsapp/pricing) para las tarifas. ## Puntos a tener en cuenta - **Meta puede recategorizar una plantilla de utilidad como marketing por iniciativa propia**, y el mensaje sigue enviándose al nuevo precio, más alto. Un negocio al que Meta ya advirtió por categorización incorrecta no recibe aviso previo alguno desde abril de 2025; el cambio se aplica de inmediato. Mantén el lenguaje promocional, las ofertas y las propuestas de compra de una opción de mayor valor fuera del texto de una plantilla de utilidad, ya que eso es lo que provoca el cambio. Consulta [Directrices de plantillas](/docs/knowledge-base/whatsapp/template-guidelines) para saber qué se considera promocional. - **Un encabezado `gif` o un botón `copy_code` se rechaza fuera de marketing.** Ambos son componentes exclusivos de marketing; declarar cualquiera de los dos en una plantilla de utilidad falla. - **Un envío con plantilla propia no se valida por cantidad de parámetros antes de cobrarse.** Envía la cantidad incorrecta de parámetros en una plantilla propia y el mensaje se acepta y se cobra, pero luego Meta lo rechaza. Los envíos del catálogo gestionado no tienen este problema. - **Un remitente en la cuenta de negocio WhatsApp incorrecta se rechaza antes de cualquier cobro.** `from` debe estar en la misma cuenta que la plantilla; de lo contrario, el envío falla `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch`. ## Próximos pasos - [Plantillas de WhatsApp](/docs/guides/whatsapp/templates): explorar el catálogo y el contrato compartido de envío por plantilla - [Plantillas de autenticación](/docs/guides/whatsapp/templates/authentication): códigos de verificación de un solo uso y la verificación necesaria para crear una - [Plantillas de marketing](/docs/guides/whatsapp/templates/marketing): envíos promocionales y la cuenta que necesitas para crear una ## Related resources - [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video) - [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer) - [WhatsApp message builder](/tools/whatsapp-message-builder) (tool) - [WhatsApp](/products/whatsapp) (product) [Get an implementation brief](/learn/workspace?topic=whatsapp)