> For the complete documentation index, see [llms.txt](https://docs.1millionbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1millionbot.com/es/chatbot/channels/whatsapp-cloud-api.md).

# WhatsApp Cloud API

## Configuración

Para configurar la integración de tu asistente en WhatsApp Cloud API, necesitarás lo siguiente:

* Una cuenta de Facebook registrada en la [consola para desarrolladores](https://developers.facebook.com/).
* Una página de Facebook conectada al Meta Business.
* Un número de teléfono disponible.

### Crear una aplicación de Meta

1. Accede a la [consola para desarrolladores de Facebook](https://developers.facebook.com/apps/).
2. Haz clic en 'Crear aplicación', selecciona 'Otro' y haz clic en 'Continuar'.\
   ![](/files/3xIVFivP7eQ9OB8jqDbf)
3. Selecciona 'Empresa' en el siguiente paso.\
   ![](/files/Cdg7Skg5oX22ZTttZ4YV)
4. En el formulario, completa todos los campos y haz clic en 'Crear aplicación'.\
   ![](/files/V8mCGCHFC3hknVdBDxDX)
5. Accede a la aplicación que acabas de crear, ve a la sección 'Panel', encuentra el módulo de WhatsApp y haz clic en 'Configurar'.\
   ![](/files/ssPT5Bpm6UOq0E73EPBe)
6. Selecciona tu cuenta de Meta Business o haz clic en 'Crear una cuenta business' para continuar.\
   ![](/files/e2IRaZEdz7ocVvAPywZx)

### Añade tu número de teléfono

1. Accede a la sección del menú **WhatsApp** > **Primeros pasos**.
2. En el paso 5, haz clic en 'Add a phone number' (Añadir número de teléfono), completa los datos y valida la vinculación con la cuenta de WhatsApp Business API a través del SMS de confirmación.\\

### Genera un Token de Acceso Permanente

1. Navega a [Facebook Business](https://business.facebook.com/).
2. En el menú lateral, selecciona **Usuarios** > **Usuarios del sistema**.\
   ![](/files/Wnlh8yImLTegsLyDFqJm)
3. Agrega un nuevo usuario con privilegios de administrador.\
   ![](/files/jAYAJueFbASTa3zXcBUM)
4. En el menú lateral, ve a **Cuentas** > **Cuentas de WhatsApp**.\
   ![](/files/6vBUWIbKWJ8zyM78wiCJ)
5. Concede permisos de control total al nuevo usuario creado.\
   ![](/files/OcnAhGUnX9ECdoDPZ2pP)
6. Regresa a la sección **Usuarios del sistema** y haz clic en **Asignar activos**.\
   ![](/files/TUJaqFY7ijFp8FnbomRt)
7. Elige la aplicación deseada y asigna permisos de administrador.\
   ![](/files/l9r1cqEj8uNoaKFTu2hQ)
8. Una vez guardado, haz clic en **Generar nuevo token**.\
   ![](/files/mckVQPfkQwITWq3WYgc9)
9. Selecciona la aplicación, establece la caducidad en **Nunca** y habilita los permisos de WhatsApp.\
   ![](/files/Mrj756qnb8zfdnDiwgAD)
10. Copia el token de autenticación generado para uso futuro.

### Obten el identificador del número de teléfono

1. Navega a la [consola para desarrolladores de Facebook](https://developers.facebook.com/apps/).
2. Accede a la aplicación creada.
3. Ve a la sección del menú **WhatsApp** > **Primeros pasos**.
4. Selecciona el teléfono vinculado y copia el ID que aparece debajo de él (ID del número de teléfono).\
   ![](/files/z4NLfXRop5ZNuXSIUzDo)

### Obten la clave secreta de la aplicación

1. Navega a la [consola para desarrolladores de Facebook](https://developers.facebook.com/apps/).
2. Accede a la aplicación creada.
3. Ve a la sección del menú **Configuración** > **Información básica**.
4. Haz clic en mostrar y copia la clave secreta de la aplicación.\
   ![](/files/LiTMC6PmaqA3iR9zzgsa)

### Conecta tu aplicación con tu assistente

#### Activar integración en la plataforma 1millionbot

1. Ve a la sección **Canales** en la plataforma.
2. Activa WhatsApp y haz clic en Configuración.
3. Ingresa los datos obtenidos previamente: Clave secreta de la aplicación, Token de acceso permanente e ID del número de teléfono.
4. Haz clic en Guardar.\
   ![](/files/CqUr9UBmnbhTnw97F955)

#### Activar integración en Meta

**Obtener Callback URL**

1. Ve a la plataforma de 1millionbot y haz clic en el botón 'Info' en el canal de WhatsApp Cloud para obtener la URL.\
   ![](/files/XUFQSmyOo2oQ61df7qp3)

**Configurar el Webhook de Meta**

1. En la sección del menú **WhatsApp** > **Configuración** de la consola de desarrolladores de Meta, haz clic en 'Editar' en la sección **Webhook**.\
   ![](/files/QMjYFmXpDC2b8E8yc0q0)
2. Pega la URL obtenida de la plataforma de 1millionbot e ingresa el Token de Autenticación Permanente.
3. Haz clic en 'Guardar' para aplicar los cambios.

### Configurar permisos

1. En la sección **WhatsApp** > **Configuración**, haz clic en 'Administrar' para activar los permisos del Webhook necesarios:\
   \- *messages*\
   ![](/files/t7KRL7erRk95It4Spxgi)
2. Haz clic en 'Guardar' para aplicar los cambios.

### Publicar la aplicación de Meta

1. Actualmente, tu aplicación está en modo de desarrollo, por lo que puedes probar el funcionamiento del asistente siempre que el número de teléfono que uses para interactuar con el asistente pertenezca a uno de los usuarios con acceso a la aplicación.
2. Para publicar el asistente para interacción pública, cambia el modo de desarrollo a producción y proporciona toda la información necesaria (que se encuentra en la parte superior de la consola de desarrolladores de Meta).\
   ![](/files/DV3rozHpswUqbkGi7p2g)
3. ¡Listo! Ahora puedes interactuar con tu bot en el número configurado a través de WhatsApp. 🎉

## Limitaciones

* Límite inicial de 1000 conversaciones por día ([+ info](https://developers.facebook.com/docs/whatsapp/messaging-limits)).
* Máximo 3 botones por mensaje.
* Cada botón puede tener un máximo de 20 caracteres.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.1millionbot.com/es/chatbot/channels/whatsapp-cloud-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
