> ## Documentation Index
> Fetch the complete documentation index at: https://meta-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comenzar

> Esta guía te ayudará a enviar y recibir tu primer mensaje usando la API Cloud. También aprenderás cómo configurar Webhooks para usar con una aplicación de ejemplo.

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](/docs/whatsapp/solution-providers/).

## Antes de Comenzar

Necesitarás:

* Una cuenta de desarrollador de Meta — [aprende más sobre cómo registrarte como desarrollador de Meta](/docs/development/register).
* Una aplicación de negocio — [aprende más sobre cómo crear aplicaciones](/docs/development/create-an-app/). Si no ves la opción para crear una aplicación de **negocio**, selecciona **Otro** > **Siguiente** > **Negocio** durante la creación de la aplicación).

## 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](/docs/whatsapp/sample-app-endpoints) 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.
