Puedes gestionar las conversaciones de tu cuenta de WhatsApp Business desde Chatwoot. Para configurarlo, tienes dos opciones para elegir tu proveedor:

1. WhatsApp Cloud API

2. Twilio

Explicaremos todos los procedimientos en esta guía.

### **Requisitos previos**

1. Necesitas una [**Cuenta de Desarrollador de Meta**](https://developers.facebook.com/) para configurar la API de WhatsApp. Si aún no tienes una cuenta de desarrollador haz clic [**aquí**](https://business.facebook.com/business/loginpage/) para crear una antes de continuar.

2. Un número de teléfono válido

## **Usando Whatsapp Cloud API**

[**WhatsApp Cloud API**](https://developers.facebook.com/docs/whatsapp/cloud-api/) está disponible para todas las empresas y desarrolladores individuales. Dado que está alojada en la infraestructura en la nube de Meta, ya no es necesario usar proveedores de terceros como Twilio, Zendesk, 360Dialog o MessageBird ([**Business Solution Providers**](https://www.facebook.com/business/partner-directory/search?solution_type=messaging)) para alojar tu API de WhatsApp Business.

## **Configura tu perfil de empresa**

Crea un perfil profesional de WhatsApp Business con el nombre de tu empresa, una descripción y tu información de contacto. Un perfil bien elaborado ayuda a los clientes a reconocer y confiar en tu marca cuando interactúan contigo.

Inicia sesión en [**https://business.facebook.com**](https://business.facebook.com/) y haz clic en el botón **crear portafolio** en el menú desplegable bajo Inicio.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS0l2TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--72176865da87c663b137ddf7e9fcc96a9895ed79/image.png)

Completa todos los campos requeridos para configurar tu portafolio de empresa.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTDB2TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b97272d17bfd653a869efa3463beb3c4e21c2b32/image.png)

Una vez que hayas creado tu portafolio de empresa, es momento de crear tu aplicación de Facebook.

## **Configura tu aplicación de Facebook**

Inicia sesión en [**https://developers.facebook.com/**](https://developers.facebook.com/) y haz clic en el botón **Crear Aplicación**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTmt2TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--98e9e282f223ba6c1925a9f6d2a7aed9ef6e558e/image.png)

Completa los campos requeridos

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUEF2TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c3a7a0ccb782a47ec460a8bfcf30cdee6d4902c1/app-2.png)

Haz clic en "Otro" de las opciones

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQUF3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ae78ade6835e127f19708f3c51595393cf0755fb/app-3.png)

Elige "Empresa" como tipo de tu aplicación

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQkV3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--653dc0f0c7137a07fb8605394443b7ce46ac518b/app-4.png)

Ingresa tu correo electrónico de contacto y selecciona tu portafolio de empresa del menú desplegable.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQnd3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--97420cad25fb464103e356169eeea2b8ee2f882e/app-6.png)

## **Agrega Whatsapp a tu aplicación**

Después de crear tu aplicación, serás dirigido al panel de control de la app. Desde allí, haz clic en **"Agregar Producto"** y selecciona **WhatsApp** de la lista de productos disponibles.

Haz clic en el botón "Configurar" para WhatsApp

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ1V3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8edbe733b323ed31919bd51914049fa87056c77d/app-7.png)

***Nota:** Antes de continuar, verifica tu empresa con Meta. Tendrás que presentar documentación para la verificación, lo cual es necesario para tener acceso completo a la API.*

## **Configura un Token de Acceso Permanente para WhatsApp Cloud API**

Necesitarás crear un **Usuario del Sistema** y generar un token permanente para mantener el acceso seguro y sin interrupciones.

Inicia sesión en tu cuenta de desarrollador de Facebook, selecciona tu aplicación de WhatsApp y navega a la [**página de configuración de empresa**](https://business.facebook.com/settings).

Haz clic en "Usuarios del sistema" y agrega un nuevo usuario del sistema con el rol **Administrador**

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRDh3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2826694996496e22a3ecf00c12269e7b77a96278/SCR-20250318-tocl.png)

Haz clic en el botón "Agregar activos", selecciona el nombre de tu aplicación, elige la opción "Control total" y haz clic en "Asignar activos".

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRWt3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--4513bf38a22f4f420c5894d64dbff22557732be0/assign-assets.png)

Vuelve a la página de **usuarios del sistema**, selecciona tu nuevo usuario del sistema de la lista y haz clic en el botón "**Generar nuevo token**".

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRnN3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--28256cc30c4ee638a5e5127fffaa61b5362eea9e/sys-1.png)

Selecciona tu aplicación del menú desplegable

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR3N3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--85305f422e394fb1aef6c146e19f936c6cd092dd/sys-2.png)

Selecciona estos tres niveles de permisos para tu token:

* whatsapp_business_manage_events

* whatsapp_business_management

* whatsapp_business_messaging

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSGt3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--45b91aa4d3d4c4481a8ce37fc1468fd00386b0fb/sys-3.png)

Copia y guarda tu token

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSUl3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9e96636a7551f8073f4c86108ab8fe3f83cfc5bf/sys-4.png)

## **Configura WhatsApp Cloud API**

Para crear una nueva cuenta de empresa de Meta, selecciona "**crear una cuenta de empresa**" del menú desplegable. Si ya tienes una cuenta de empresa, puedes seleccionarla de las opciones ya existentes. He seleccionado "**crear una cuenta de empresa**". Haz clic en el botón ***continuar***.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSXd3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--103af678530aa76e8768d7a3d530dd4aef96377e/api-0.png)

Pega tu token permanente aquí

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSnd3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--403311ae1ce0523a626d6b00dac00e4f74949e6a/api-1.png)

Agrega tu número de teléfono listo para producción

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS013TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--cd7b500250f5adc96b90d8e7e3b8cc5bbdfb77a6/api-2.png)*Nota*: Meta requiere un número de teléfono verificado para la configuración de la API de WhatsApp. Puedes verificar tu número usando una OTP (contraseña de un solo uso).

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTFF3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e3505e8fbd4c9400883212aed134a0e6c6743ef4/api-3.png)

Una vez que hayas agregado y verificado tu número de teléfono, el siguiente paso es configurar un webhook para recibir mensajes entrantes.

## **Conectando tu cuenta de Chatwoot**

Conectemos tu cuenta de Chatwoot con tu WhatsApp Cloud API

Copia tu ID de número de teléfono de WhatsApp y el ID de la cuenta de empresa desde esta sección

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTVl3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--5817b729bb5f9311f620914e1410c3cba09a988d/phid.png)

Inicia sesión en tu cuenta de Chatwoot, ve a Configuración > Bandeja de entrada, y selecciona el canal WhatsApp

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTTR3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--34b0791786e1b9185b78563057d4dd6d6d2eeef6/cw-1.png)

Ingresa tu número de teléfono, el ID del número de teléfono y el ID de empresa de tu configuración de API de WhatsApp

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT1V3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--36b14c0dff0a29cb3de0a07be4a8fa42f649decb/cw-2.png)

Agrega miembros del equipo a tu bandeja de entrada de WhatsApp

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFl3TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--aff01faf7c0ba58daf722b218a378ebdae62617d/cw-3.png)

Copia la URL del webhook y el token de verificación del webhook que se muestra aquí

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQVl4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ebc9f3052573b38afdd96995bfd97af6e9ed75cc/cw-4.png)

## **Configura tu Webhook**

Necesitamos configurar el webhook de WhatsApp para recibir los mensajes de clientes enviados a tu número de empresa.

Tu URL de devolución de llamada debe tener el formato [**https://app.chatwoot.com/webhooks/whatsapp/{phone_number}**](https://app.chatwoot.com/webhooks/whatsapp/%7Bphone_number%7D).

Inicia sesión en tu cuenta de desarrollador de Facebook y navega a WhatsApp > Configuración

Pega aquí la URL de tu webhook de Chatwoot y el token de verificación, luego haz clic en "Verificar y guardar"

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQmN4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3802889ac4ce26cd2264b6dab4267fd1cb6afe53/hk-1.png)

Configura los permisos del webhook suscribiéndote a los mensajes

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ1V4TlFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a8d5c4c957aa29875247a3b135eb2acf945fddcc/hk-2.png)

¡Eso es todo! Ya puedes comenzar a enviar mensajes de WhatsApp a través de Chatwoot.

### **Preguntas frecuentes (FAQ’s)**

**¿Cómo configurar varios números bajo una sola aplicación de Facebook?**

La aplicación de Facebook permite configurar solo un único endpoint de Webhook. Así que crea Bandejas de entrada en Chatwoot para todos los números que sean necesarios. Deberás configurar la URL de Webhook proporcionada solo para una de estas bandejas en la app de Facebook para que todas las demás funcionen.

**¿Qué tipo de plantillas de WhatsApp son compatibles con Chatwoot?**

Por favor consulta la [**documentación**](https://www.chatwoot.com/hc/user-guide/articles/1754940076-whatsapp-templates) para más detalles sobre las plantillas.

**¿Qué tipos de medios son compatibles?**

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRHZuSWdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--469bfec94ea6ac0381da7d5223e83312dbaf5ca9/image.png)