# API en la nube de WhatsApp
{% hint style="info" %}
Para conectar la API de WhatsApp Cloud, se necesita una aplicación de Facebook con Whatsapp Product activado. Lee esta guía sobre cómo configurar tu app de Facebook.
{% endhint %}
Facebook anunció el lanzamiento de WhatsApp Cloud API el 20 de mayo, y está disponible para cualquier negocio de cualquier tamaño, grande o pequeño, para comunicarse con los clientes utilizando la API oficial de WhatsApp.
{% hint style="warning" %}
Este canal tiene una ventana de mensajería limitada de 24 horas debido a las regulaciones de WhatsApp. ¡Descubre más aquí!
{% endhint %}
## Cómo conectar la API de WhatsApp Cloud
Para chatear con tus clientes a través de la API de WhatsApp Cloud, conecta un perfil de WhatsApp Business y una cuenta de Facebook Business.
{% hint style="warning" %}
La aplicación de Facebook y la cuenta de empresa de Facebook son necesarias y debes ser el administrador de ambas para conectarte.
{% endhint %}
#### Paso 1: Navegar a la configuración del canal
Desde el Módulo de Configuración, navegue hasta la opción de menú, Canales.
#### Paso 2: Añadir canal
Pulse Añadir canal y elija WhatsApp. Debería abrirse el cuadro de diálogo Conectando la API de WhatsApp Cloud.
#### Paso 3: Conectar con Facebook
Pulsa el botón Conectar con Facebook.
#### Paso 4: Iniciar sesión con una cuenta de Facebook
Inicia sesión con la cuenta de Facebook que tiene acceso de administrador a la aplicación de Facebook y a la cuenta de empresa de Facebook.
#### Paso 5: Seleccionar el número de WhatsApp
Se le proporcionarán opciones sobre qué número junto con el nombre de WABA desea conectar. Seleccione el número
#### Paso 6: Añadir la URL de devolución de llamada
Vuelve a la sección de WhatsApp en la aplicación para desarrolladores de Facebook. Ve a la subsección de Configuración y configura la URL de devolución de llamada. Añade la URL de devolución de llamada generada y el token de verificación de respond.io en los campos correspondientes del diálogo de webhook.
#### Paso 7: Verificar y guardar los cambios
En la aplicación de Facebook, verifica y guarda los cambios en la aplicación.
#### Paso 8: Suscripción al evento webhook
En su aplicación de Facebook, seleccione el producto webhooks y seleccione la cuenta de WhatsApp Business en la lista desplegable. Haz clic en el evento de suscripción de mensajes.
#### Paso 9: Completar la configuración en 1980tic Cloud
Pulse DONE para completar la configuración
{% hint style="success" %}
Una vez que haya completado la configuración, todos los mensajes enviados a su número de WhatsApp se recibirán ahora en su Espacio.
{% endhint %}
## Configuración del canal
{% hint style="info" %}
El canal de la API de WhatsApp Cloud puede configurarse con un nombre de canal único.
{% endhint %}
#### Paso 1: Navegar a la configuración del canal
Desde el Módulo de Configuración, navegue hasta la opción de menú, Canales
#### Paso 2: Localizar el canal de la API de WhatsApp Cloud
Una vez que hayas localizado el canal de la API de WhatsApp Cloud, pulsa Configurar
#### Paso 3: Realizar la configuración necesaria
Puede configurar lo siguiente:
* Nombre del canal - Nombre utilizado internamente para identificar la cuenta
#### Paso 4: Actualizar la configuración
Presione Done para actualizar la configuración del canal
## Gestión del perfil de la API de WhatsApp Business
{% hint style="info" %}
Si hay una necesidad de hacer un cambio o comprobar su perfil de la API de WhatsApp Business, se puede hacer en la plataforma 1980Tic.
{% endhint %}
#### Paso 1: Navegar a la configuración del canal
Desde el Módulo de Configuración, navegue hasta la opción de menú, Canales
#### Paso 2: Localizar el canal de la API de WhatsApp Cloud
Una vez que haya localizado el canal de la API de WhatsApp Cloud, pulse Perfil
#### Paso 3: Sincronizar el perfil
Si el perfil no se ha sincronizado, pulse Sincronizar perfil para obtener la información más reciente del perfil empresarial de WhatsApp
#### Paso 4: Realizar los cambios necesarios
Puede editar la información según sea necesario.
| Campos | Descripción |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Foto de perfil |
magen mostrada como foto de perfil de la cuenta de WhatsApp Business
Se recomienda un tamaño de imagen de 640x640.
|
| Dirección | Dirección de la empresa. Un máximo de 256 caracteres. |
| Descripción | Descripción de la empresa. Un máximo de 512 caracteres. |
| Correo electrónico | Dirección de correo electrónico (en formato de correo electrónico válido) para contactar con la empresa. Un máximo de 128 caracteres. |
| Vertical | Industria de la empresa. Debe ser uno de estos valores aceptados: Automoción Belleza, Spa y Salones de Belleza Ropa y prendas de vestir Educación Entretenimiento Planificación y servicio de eventos Finanzas y banca Alimentación y tienda de comestibles Servicios públicos Hotelería y alojamiento Medicina y Salud Sin ánimo de lucro Servicios profesionales Compras y comercio minorista Viajes y transportes Restaurante Otros La vertical de negocio no puede ser devuelta a un valor vacío después de ser creada. |
| Página web | URLs (incluyendo http\:// o https\://) asociadas a la empresa (por ejemplo, sitio web, página de Facebook, Instagram). Un máximo de 2 sitios web con un máximo de 256 caracteres cada uno. |
#### Paso 5: Guardar los cambios
Revise la información y pulse GUARDAR cuando esté listo.
## Gestión de plantillas de mensajes de WhatsApp
{% hint style="info" %}
Antes de enviar un mensaje de plantilla a un contacto en la plataforma respond.io, asegúrese de que el mensaje de plantilla está aprobado
{% endhint %}
### Sincronización de plantillas de mensajes
#### Paso 1: Navegar a la configuración del canal
Desde el Módulo de Configuración, navegue hasta la opción de menú, Canales
#### Paso 2: Localizar el canal de la API de WhatsApp Cloud
Una vez localizado el canal de la API de WhatsApp Cloud, pulse Plantillas
#### Paso 3: Sincronizar plantillas
Pulse Sincronizar plantillas para iniciar el proceso de sincronización.
#### Paso 4: Sincronización completada
Cuando la sincronización se haya completado, las plantillas de mensajes aparecerán con su correspondiente estado y se actualizará la fecha de la última sincronización. El motivo del rechazo se mostrará debajo de la plantilla de mensajes rechazada.
| Estatus | Descripción |
| --------- | --------------------------------------------------------------------------- |
| Enviado | El modelo de mensaje se ha enviado y está pendiente de aprobación. |
| Aprobado | La plantilla del mensaje está aprobada y puede ser enviada a los contactos. |
| Rechazado | El modelo de mensaje es rechazado y no puede ser utilizado. |
{% hint style="info" %}
Puede utilizar la búsqueda y el filtro en la esquina superior derecha del listado para encontrar sus plantillas más fácilmente.
{% endhint %}
### Presentación de la plantilla de mensajes
#### Paso 1: Navegar a la configuración del canal
Desde el Módulo de Configuración, navegue hasta la opción de menú, Canales
#### Paso 2: Localizar el canal de la API de WhatsApp Cloud
Una vez localizado el canal de la API de WhatsApp Cloud, pulse Plantillas
#### Paso 3: Enviar la plantilla
Presione Enviar Plantilla para enviar una Plantilla de Mensaje para su aprobación
#### Paso 4: Rellenar la información requerida
Rellene la información necesaria para crear una nueva plantilla
| Campo | Descripción |
| --------- | ------------------------------------------------------------------------------------------- |
| Nombre | El nombre sólo puede contener caracteres alfanuméricos en minúsculas y guiones bajos ( \_ ) |
| Categoría | La categoría a la que pertenece la plantilla de mensajes. |
| Idioma | El idioma en el que está escrita la plantilla. |
#### Paso 5: Empezar a construir el mensaje
Construya el mensaje rellenando los componentes necesarios y compruebe el mensaje en la sección de vista previa.
| Bloque de construcción | Descripción |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Encabezado | El encabezado es opcional y sirve como título o cabecera de su plantilla. Admite lo siguiente: Texto Imagen Vídeo Documento \*La plataforma Respond.io acepta cargas de hasta 20 MB. |
| Cuerpo | El cuerpo debe contener el texto más importante de su plantilla. Sólo se admite texto. Puede utilizar markdown para formatear el contenido de este bloque |
| Pie de página | El pie de página sólo admite texto y puede utilizarse para proporcionar información menos relevante en su mensaje de plantilla |
| Botón | El botón añade interactividad a sus plantillas. Hay dos tipos principales. Botón de respuesta rápida Se utiliza para obtener respuestas rápidas de su cliente Máximo 3 botones de respuesta rápida por plantilla Cada respuesta rápida no puede tener más de 20 caracteres Botón de llamada a la acción Se utiliza para enviar a su cliente a un sitio web o llamar a un número de teléfono Máximo una URL y un número de teléfono por plantilla La URL puede tener un parámetro de personalización |
#### Paso 6: Proporcionar el valor de la muestra
Esto sólo es aplicable si ha incluido algún parámetro en el contenido de la plantilla del mensaje.
{% hint style="info" %}
Proporcionar valores de muestra al parámetro en la plantilla del mensaje ayudará a la revisión a entender el mensaje que está tratando de enviar a sus contactos
{% endhint %}
{% hint style="info" %}
Puede utilizar variables dinámicas para rellenar el parámetro de la plantilla de mensajes.
{% endhint %}
#### Important Links Message guidelines by WhatsApp
Directrices de mensajes por whatsApp
## Solución de problemas
#### Imposibilidad de enviar mensajes
Asegúrate de que el número que has conectado a la plataforma es un número de la API de WhatsApp Cloud.
### Los mensajes no llegan
{% hint style="info" %}
Esto puede ocurrir cuando el webhook de mensajes no está suscrito.
{% endhint %}
#### Paso 1: Accede a la página de Facebook App Webhook
Abre la aplicación de Facebook y ve a la página de Webhooks.
#### Paso 2: Verificar el evento suscrito
Seleccione la cuenta de Whatsapp Business y verifique si el evento de mensajes está suscrito.
#### Paso 3: Enviar un mensaje de prueba
Envía un mensaje de prueba al número de teléfono de WhatsApp y comprueba si ha llegado.
### Imposibilidad de recibir recibos de lectura
{% hint style="info" %}
Ocasionalmente, cuando el usuario que se conectó a la API de WhatsApp Cloud cambia su contraseña de Facebook y el permiso quedará obsoleto. Será necesario actualizar los permisos.
{% endhint %}
#### Paso 1: Navegar a la configuración del canal
Desde el Módulo de Configuración, navegue hasta la opción de menú, Canales
#### Paso 2: Localizar el canal de la API de WhatsApp Cloud
Una vez localizado el canal de WhatsApp Cloud API Messenger, pulse Solucionar problemas
#### Paso 3: Actualizar el permiso
Pulse Actualizar permiso para actualizar los permisos de WhatsApp.
#### Paso 4: Enviar un mensaje de prueba
Envía un mensaje de prueba al número de teléfono de WhatsApp y comprueba si ha llegado.
### Contacto que no recibe mensajes
{% hint style="info" %}
Esto puede ocurrir cuando el contacto no ha aceptado las condiciones y la política de privacidad de WhatsApp
{% endhint %}
Si tus contactos no pueden recibir mensajes desde tu número de la API de WhatsApp Cloud, asegúrate de que han aceptado las últimas condiciones y la política de privacidad de WhatsApp.
{% hint style="warning" %}
¿Tiene problemas con el canal? Contacta con nosotros aquí.
{% endhint %}
## Preguntas frecuentes
### Qué consideración tiene el número de teléfono que permite añadir a la API de WhatsApp Cloud?
* Si el número ya se está utilizando en la aplicación de cliente o empresa de WhatsApp, tendrás que eliminar tu cuenta en la aplicación de cliente o empresa de WhatsApp.
* El número de teléfono utilizado para la API de WhatsApp Cloud no puede utilizarse en la aplicación de WhatsApp para clientes o empresas.
* Puedes seguir utilizando el número para fines cotidianos, como llamar y recibir mensajes después de registrarlo en la plataforma WhatsApp Business.
* Una vez que utilice un teléfono para la API de WhatsApp Cloud, ya no podrá utilizar ese número en la aplicación WhatsApp Business.
### ¿Es necesaria la verificación de la empresa para empezar a utilizar la API de la nube?
No es obligatorio completar la verificación empresarial de Facebook para empezar a enviar mensajes en WhatsApp. Sin la verificación empresarial, tu negocio podrá seguir
* Responder a un número ilimitado de conversaciones iniciadas por los clientes.
* Enviar conversaciones iniciadas por la empresa (mensajes de plantilla) a 50 clientes únicos en un periodo de 24 horas consecutivas. Deberá completar la verificación de la empresa si desea iniciar más de 50 conversaciones iniciadas por la empresa en un periodo de 24 horas consecutivas.
Las empresas pueden iniciar la Verificación de Empresas (BV) sólo cuando estén preparadas para ampliar las conversaciones iniciadas por las empresas o quieran convertirse en una Cuenta Oficial de Empresas.
### ¿Puedo ver mi conversación desde mi cuenta de WhatsApp Business?
Sí, puedes monitorizar tus mensajes y análisis de gastos en tiempo real para tu cuenta de WhatsApp business en la pestaña Insights de tu Meta WhatsApp Manager. Lee más aquí.
### ¿Qué son los límites de la mensajería de WhatsApp?
Los límites de mensajería determinan el número máximo de conversaciones iniciadas por la empresa que cada número de teléfono puede iniciar en un periodo de 24 horas consecutivas. Estos límites no se aplican a las conversaciones iniciadas por el usuario. Una conversación iniciada por la empresa comienza cuando se entrega el primer mensaje a un cliente y termina 24 horas después. Lea más aquí.
### ¿Cómo añadir un método de pago a mi cuenta de WhatsApp Business?
Sus primeras 1.000 conversaciones al mes son gratuitas. Si quieres superar el nivel gratuito de 1.000 conversaciones al mes, tienes que añadir un método de pago a tu cuenta de WhatsApp Business en Business Manager. Puede obtener más información aquí
### ¿Cuál es el precio de la API de WhatsApp Cloud?
Las conversaciones de la plataforma WhatsApp Business se dividen en dos categorías que tienen precios diferentes:
* Iniciada por el usuario: Una conversación que se inicia en respuesta a un mensaje del usuario. Siempre que una empresa responda a un usuario dentro de la ventana de atención al cliente de 24 horas, ese mensaje se asociará a una conversación iniciada por el usuario. Las empresas pueden enviar mensajes de forma libre dentro de esta ventana de atención al cliente de 24 horas.
* Iniciada por la empresa: Una conversación que se inicia desde una empresa que envía a un usuario un mensaje fuera de la ventana de atención al cliente de 24 horas. Los mensajes que inician una conversación iniciada por una empresa requerirán una plantilla de mensaje.
Todas las conversaciones se miden en sesiones fijas de 24 horas. Una conversación comienza cuando se entrega el primer mensaje de empresa en una conversación, ya sea iniciado por la empresa o en respuesta a un mensaje de usuario. Las empresas y los usuarios pueden intercambiar cualquier número de mensajes, incluidos los mensajes de plantilla, dentro de una sesión de conversación de 24 horas sin incurrir en cargos adicionales. Cada sesión de conversación de 24 horas supone un único cargo.
Las tarifas de las conversaciones se basan en el código de país del usuario. Un usuario se define aquí como el cliente con el que su empresa se comunica. Las tarifas de las conversaciones iniciadas por la empresa y por el usuario varían según el país o la región. Más información
### ¿Cómo eliminar el número de teléfono de una cuenta de empresa?
Hay algunos requisitos y pasos necesarios para eliminar un número de teléfono, lea más aquí
---
# Agent Instructions: 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:
```
GET https://docs.1980tic.us/canales-de-mensajeria/whatsapp/chat-api-whatsapp.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.