Saltar al contenido principal
Esta guía está destinada a personas que desarrollan aplicaciones para sí mismos o su organización. Si estás desarrollando una aplicación que será utilizada por otros negocios, consulta Proveedores de Soluciones.

Antes de Comenzar

Necesitarás:

Paso 1: Agregar el Producto WhatsApp a Tu Aplicación

En este punto, si creaste una nueva aplicación, se te pedirá Agregar productos a tu aplicación. Desplázate hacia abajo y bajo WhatsApp, selecciona Configurar. De lo contrario, selecciona tu aplicación desde la pantalla Mis Aplicaciones, y puedes seguir las mismas instrucciones nuevamente para agregar el producto WhatsApp a tu aplicación. Si tienes una Cuenta Comercial de Meta (MBA), se te pedirá que la adjuntes al agregar el producto WhatsApp a tu aplicación. Si no tienes una MBA, se te guiará a través de algunos pasos que te ayudarán a crear una. Una vez que tu MBA esté adjunta a tu aplicación, estarás listo para comenzar a realizar pruebas. Agregar el producto WhatsApp a tu aplicación hace varias cosas por ti:
  • Te solicita crear una Cuenta Comercial de Meta si no tienes una.
  • Crea automáticamente una cuenta de WhatsApp Business de prueba. Esta cuenta tiene limitaciones y está destinada para propósitos de prueba y desarrollo ya que no pagas por los mensajes.
  • Crea un número de teléfono comercial de prueba asociado con tu cuenta de WhatsApp Business. Con este número, puedes enviar mensajes gratuitos a hasta 5 números de teléfono destinatarios.
  • Crea un conjunto de plantillas de mensajes pre-aprobadas.

Paso 2: Agregar un Número Destinatario

Agrega un número válido de WhatsApp al que puedas enviar mensajes de prueba. En el menú izquierdo del Panel de la Aplicación, navega a WhatsApp > Configuración de API. Bajo Enviar y recibir mensajes, selecciona el campo Para y elige Administrar lista de números de teléfono. Puedes agregar cualquier número válido de WhatsApp como destinatario. El número destinatario recibirá un código de confirmación en WhatsApp que se puede usar para verificar el número. Una vez que verifiques el número destinatario, debería estar seleccionado en el campo Para. Repite este proceso si deseas agregar otro destinatario, hasta un total de 5.

Paso 3: Enviar un Mensaje de Prueba

Envía la plantilla de mensaje pre-aprobada hello_world a tu número destinatario elegido. En el panel WhatsApp > Configuración de API:
  1. Asegúrate de que tu número de teléfono comercial de prueba esté seleccionado en el campo De.
  2. Asegúrate de tener seleccionado el número de teléfono destinatario al que deseas enviar mensajes en el campo Para. Si tienes múltiples números agregados, puedes enviar múltiples mensajes a la vez.
  3. En el panel Enviar mensajes con la API, haz clic en el botón Enviar mensaje.
Alternativamente, puedes copiar el comando cURL, pegarlo en una nueva ventana de terminal y ejecutarlo. Observa que el código indica que estás enviando un mensaje de plantilla ("type":"template") e identificando una plantilla específica para usar ("name":"hello_world").

Paso 4: Clonar Nuestra Aplicación de Ejemplo y Configurar Webhooks

Con webhooks, puedes recibir notificaciones HTTP en tiempo real de cambios en objetos específicos. En WhatsApp, los webhooks pueden notificarte de muchos eventos en tu aplicación, como notificaciones de entrega y lectura de mensajes, e incluso cambios en la cuenta. Agrega una URL de callback para ver el contenido de los webhooks. Sigue nuestra Guía de URL de Callback de Ejemplo para Pruebas de Webhooks para clonar nuestra aplicación de ejemplo, que acepta notificaciones de webhooks y muestra sus cargas JSON en pantalla. Una vez que tu webhook esté configurado, reenvía el mensaje de plantilla y luego responde a él. Deberías ver 4 notificaciones de webhook separadas: Las notificaciones de envío, entrega y lectura del mensaje, y el contenido del mensaje entrante.

Paso 5: (Opcional) Agregar un Número Comercial Real

Con tu número comercial de prueba y cuenta de WhatsApp Business de prueba, puedes comenzar a desarrollar tu aplicación. Cuando uses estos activos de prueba, no pagas por enviar mensajes mientras trabajas en desarrollar tu aplicación. Una vez que estés listo para comenzar a enviar mensajes a tus clientes, puedes agregar un número de teléfono comercial real en el panel Configuración de API y crear una cuenta real de WhatsApp Business.