Si estás desarrollando una app que usarán otras empresas, consulta nuestras guías Primeros pasos para proveedores de tecnología o Primeros pasos para socios de soluciones.
Primeros pasos
Esta guía te ayudará a enviar y recibir tu primer mensaje usando la API de la nube. También aprenderás a configurar Webhooks para usar con una app de ejemplo.
Esta guía está dirigida a personas que desarrollan apps para sí mismas o para su organización. Si estás desarrollando una app que utilizarán otras empresas, consulta los documentos Primeros pasos para socios de soluciones o Primeros pasos para proveedores de tecnología.
Antes de empezar
Deberás hacer lo siguiente:
- Contar con una cuenta de desarrollador de Meta: obtén más información sobre cómo registrarte como desarrollador de Metas.
- Contar con una app de negocios: obtén más información sobre cómo crear apps (si no ves una opción para crear una app denegocios, selecciona Otra > Siguiente > Negocios).
Paso 1: Agrega el producto WhatsApp a tu app
En este punto, si creaste una app nueva, se te pedirá que le agregues productos. Desplázate hacia abajo y en WhatsApp, selecciona Configurar. O selecciona tu app en la pantalla Mis apps y sigue las mismas instrucciones para agregar WhatsApp a tu app.
Si tienes una cuenta comercial de Meta (MBA), se te pedirá que la adjuntes cuando agregues el producto WhatsApp a tu app. Si no tienes una MBA, deberás seguir unas instrucciones que te ayudarán a crear una. Una vez que adjuntes la MBA a tu app, tendrás todo listo para empezar a hacer las pruebas.
Cuando agregas el producto WhatsApp a tu app, ocurre lo siguiente:
- Se te pide que crees una cuenta comercial de Meta, si no tienes una.
- Se crea automáticamente una cuenta de WhatsApp Business de prueba. Esta cuenta tiene limitaciones, por lo que debes usarla para pruebas y desarrollo, ya que no se pagan los mensajes.
- Se genera un número de teléfono de empresa de prueba y se lo asocia con tu cuenta de WhatsApp Business. Con este número, puedes enviar mensajes gratis a hasta 5 números de teléfono de destinatarios.
- Se crea un conjunto de plantillas de mensajes preaprobadas.
Paso 2: Agrega un número de destinatario
Agrega un número de WhatsApp válido al que puedas enviar mensajes de prueba.
En el menú de la izquierda del panel de apps, navega hasta WhatsApp > Configuración de la API. En Enviar y recibir mensajes, selecciona el campo Para y, luego, Administrar lista de números de teléfono.
Puedes agregar cualquier número de WhatsApp válido como destinatario. El número del 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 del destinatario, se debería poder seleccionar en el campo Para. Repite este proceso si quieres agregar otro destinatario. Puedes agregar hasta 5 en total.
Paso 3: Envía un mensaje de prueba
Envía la plantilla de mensaje preaprobada hello_world al número del destinatario que elegiste.
En el panel WhatsApp > Configuración de la API:
- Asegúrate de que el número de teléfono del negocio de prueba esté seleccionado en el campo De.
- Asegúrate de que el número de teléfono del destinatario al que deseas enviarle un mensaje esté seleccionado en el campo Para. Si agregaste varios números, puedes enviar varios mensajes a la vez.
- En el panel Enviar mensajes con la API, haz clic en el botón Enviar mensaje.
Como alternativa, puedes copiar el comando cURL, pegarlo en una nueva ventana de terminal y ejecutarlo.
Ten en cuenta 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: Clona nuestra app de prueba y configura webhooks
Con los webhooks, puedes recibir notificaciones HTTP en tiempo real sobre cambios en objetos específicos. En WhatsApp, los webhooks pueden notificarte sobre muchos eventos que ocurren en tu app, como la entrega de mensajes y la lectura de notificaciones, e incluso los cambios de cuenta.
Agrega una URL de devolución de llamada para ver el contenido de los webhooks. Sigue nuestra guía "Ejemplo de URL de devolución de llamada para probar webhooks" para clonar nuestra app de prueba, que acepta notificaciones de webhooks y muestra en pantalla sus cargas útiles JSON.
Una vez que configures tu webhook, vuelve a enviar el mensaje de plantilla y luego respóndele. Deberías ver 4 notificaciones de webhook separadas: el mensaje enviado, el mensaje entregado, las notificaciones leídas y el contenido de los mensajes entrantes. ¡Buen trabajo!
Paso 5 (opcional): Agrega un número de empresa real
Con tu número de empresa y tu cuenta de WhatsApp Business de prueba, puedes comenzar a desarrollar tu app. Cuando usas estos activos de prueba, no pagas por enviar mensajes mientras desarrollas tu app.
Una vez que tengas todo listo para empezar a enviar mensajes a tus clientes, puedes agregar un número de teléfono de una empresa real en el panel Configuración de la API y crear una cuenta real de WhatsApp Business.