Introducción
Esta te guía te ayudará a enviar y recibir tu primer mensaje con la API de nube. También obtendrás información sobre cómo configurar webhooks para usarlos con una aplicación de muestra.
Esta guía está destinada a los usuarios que desarrollan aplicaciones para sí mismos o para su organización. Si vas a desarrollar una aplicación que utilizarán otras empresas, consulta Proveedores de soluciones.
Antes de empezar
Necesitarás lo siguiente:
- Una cuenta de desarrollador de Meta: obtén más Información sobre cómo registrarte como desarrollador de Meta.
- Una aplicación empresarial: obtén más información sobre cómo crear aplicaciones. Si no ves una opción para crear una aplicación empresarial, selecciona Otros > Siguiente > Empresa durante la creación de la aplicación.
Paso 1: Añadir el producto WhatsApp a la aplicación
En este punto, si has creado una nueva aplicación, se te pedirá que añadas productos a la aplicación. Desplázate hacia abajo y, en WhatsApp, selecciona Configurar. De lo contrario, selecciona tu aplicación en la pantalla Mis aplicaciones y vuelve a seguir las mismas instrucciones para añadir el producto WhatsApp a la aplicación.
Si tienes una cuenta empresarial de Meta (MBA), se te pedirá que la adjuntes cuando añadas el producto WhatsApp a la aplicación. Si no tienes ninguna cuenta MBA, deberás seguir las instrucciones para crear una. Una vez que hayas adjuntado la cuenta MBA a la aplicación, ya podrás empezar a realizar pruebas.
Cuando añadas el producto WhatsApp a la aplicación, sucederá lo siguiente:
- Se te pedirá que crees una cuenta empresarial de Meta si todavía no tienes una.
- Automáticamente, se creará una cuenta de WhatsApp Business de prueba para ti. Esta cuenta tiene limitaciones y está concebida con fines de pruebas y desarrollo, ya que no pagas los mensajes.
- Se creará un número de teléfono de empresa de prueba y se asociará a tu cuenta de WhatsApp Business. Con este número, puedes enviar mensajes gratuitos a un máximo de cinco números de teléfono de destinatarios.
- Se creará un conjunto de plantillas de mensajes aprobadas previamente.
Paso 2: Añadir un número de destinatario
Añade un número de WhatsApp válido al que puedas enviar mensajes de prueba.
En el menú de la izquierda del panel de aplicaciones, ve a WhatsApp > Configuración de la API. En Enviar y recibir mensajes, selecciona el campo Para y elige Administrar la lista de números de teléfono.
Puedes añadir cualquier número de WhatsApp válido como destinatario. El número del destinatario recibirá un código de confirmación en WhatsApp que servirá para verificar el número.
Una vez que se haya verificado el número del destinatario, debería aparecer seleccionado en el campo Para. Repite este proceso si quieres añadir otro destinatario, hasta un máximo de cinco.
Paso 3: Enviar un mensaje de prueba
Envía el mensaje de plantilla hello_world aprobado previamente al número de destinatario que hayas elegido.
En la ventana WhatsApp > Configuración de la API, haz lo siguiente:
- Asegúrate de que el número de teléfono de empresa de prueba esté seleccionado en el campo De.
- Asegúrate de que el número de teléfono del destinatario al que quieres enviar el mensaje esté seleccionado en el campo Para. Si has añadido varios números, puedes enviar más de un mensaje a la vez.
- En la ventana Enviar mensajes con la API, haz clic en el botón Enviar mensaje.
También puedes copiar el comando cURL, pegarlo en una nueva ventana del terminal y ejecutarlo.
Fíjate en que el código indica que vas a enviar un mensaje de plantilla (”type”:”template”) y que identificas una plantilla específica para usarla (”name”:”hello_world”).
Paso 4: Clonar nuestra aplicación de muestra y configurar webhooks
Gracias a los webhooks, puedes recibir notificaciones HTTP en tiempo real de los cambios que se produzcan en determinados objetos. En WhatsApp, los webhooks pueden informarte de muchos eventos que se producen en tu aplicación, como la entrega de mensajes y las notificaciones leídas, e incluso los cambios en la cuenta.
Añade una URL de devolución de llamada para poder ver el contenido de los webhooks. Sigue nuestra guía Ejemplo de URL de devolución de llamada para las pruebas con los webhooks para clonar nuestra aplicación de muestra, que acepta las notificaciones de los webhooks y muestra sus cargas útiles JSON en la pantalla.
Una vez configurado el webhook, vuelve a enviar el mensaje de plantilla y responde al mensaje. Deberías ver cuatro notificaciones de webhooks diferentes: las notificaciones de envío, entrega y lectura del mensaje, y el contenido del mensaje entrante.
Paso 5: (Opcional) Añadir un número de empresa real
Con el número de empresa de prueba y la cuenta de WhatsApp Business de prueba, ya puedes empezar a desarrollar la aplicación. Al usar estos recursos de prueba, no pagas por enviar mensajes, ya que trabajas para desarrollar la aplicación.
Cuando lo tengas todo listo para empezar a enviar mensajes a tus clientes, puedes añadir un número de teléfono de empresa real en la ventana Configuración de la API y crear una cuenta de WhatsApp Business real.