GUÍA PRÁCTICA - CÓMO INTEGRAR WHATSAPP A XINTEL

Antes de empezar:

**¿Qué necesito para integrarme a Whatsapp API?**

Contar con una linea: chip o número que se pueda utilizar para integrarse a WhatsApp. Debes tener en cuenta que es línea, una vez integrada, NO podrá volver a ser utilizada desde un teléfono o Whatsapp Web. La linea a su vez no debe estar conectada actualmente a Whatsapp. Si lo está, deberás primero eliminar la vinculación actual.

Tener un Negocio en Meta Business Suite: Se trata de un administrador comercial donde gestionas tus cuentas de Facebook, Instagram y ahora también Whatsapp. Deberás ser administrador del negocio para poder hacer la vinculación.

Una forma de pago: Meta solicita al momento de desarrollar la integración colocar una forma de pago en la cuenta (tarjeta de crédito) Esto se debe a que Whatsapp cobra luego de las 1000 primeras conversaciones por mes. El costo por conversación es de U$S 0.06312 actualmente.

¡Ahora sí! Pasos para obtener las credenciales de Whatsapp API:

1. Crear una cuenta de Negocio en Meta Business (ex Facebook Business)

La puedes crear desde el siguiente enlace:

​​https://business.facebook.com/overview

2. Crear una cuenta de desarrollador de Facebook

Estás a punto de solicitar la integración de WhatsApp es por ello que primero debes crear una cuenta desarrollador.

Desde aquí podrás hacerlo:

https://developers.facebook.com/docs/development/register

3. Crear una aplicación en Facebook

Lo siguiente es crear tu aplicación en Facebook para poder integrar WhatsApp y poder enviar mensajes.


En el siguiente enlace oficial podrás seguir el paso a paso y conseguirlo:

https://developers.facebook.com/docs/development/create-an-app/

Así mismo te dejamos nuestro paso a paso más resumido:

Primero ingresa en: https://developers.facebook.com/apps/
Elige “Crear aplicación”
Luego debes seleccionar tipo “Negocios”



En este proceso también debe agregar el producto WhatsApp a tu aplicación.

4. Crear una cuenta de WhatsApp Business API, Vincular número y cargar forma de pago.

Para ello debemos ingresar a la sección de la aplicación:

https://developers.facebook.com/apps/




Completamos los campos:


Recuerda. que el número ingresado no debe estar en WhatsApp ni en WhatsApp Business.

Si es el primer caso, debes eliminar la cuenta, aquí te explicamos cómo:
https://faq.whatsapp.com/605464643328528/?locale=es_ES

Luego elige el método que prefieras y verifica el número.

5.Generar un Token permantente para la API de WhatsApp

Debemos ingresar a:

https://business.facebook.com/settings/

Luego ir a la sección Usuarios -> Usuarios de sistema:


Luego en “Agregar”:


Ponemos cualquier nombre y que sea el tipo Administrador.


En la siguiente pantalla elegimos “Agregar activos” y seleccionamos la aplicación creada en el paso 4.



Ahora si podremos crear el nuevo token desde: “Generar nuevo token” y elegimos la aplicación:


Ahora debemos tildar los siguientes permisos:

- business_management
- whatsapp_business_messaging
- whatsapp_business_management

Ahí obtendremos el token que debemos copiar y guardar ya que será necesario posteriormente:

6. Configurar Webhook

Ahora configuraremos el Webhook para poder recibir las notificaciones en Terzapp. Para ello vamos a:



En url ingresamos:
https://app.terzapp.com/api/v1/webhook-whatsapp

Y en token de verificación:
a183048e0b9ba0251a3aeb4af186b5f4

Ahora toca elegir “Campos del webhook” y debemos suscribirnos a:
- message_template_status_update
- messages

7. Recopilamos la información necesaria

Si hicimos todo bien, ingresando a:
https://business.facebook.com/wa/manage/home/

Veremos algo como:


La URL en el navegador en este momento debe ser:

https://business.facebook.com/wa/manage/home/?business_id=1111111111111&waba_id=1111111111111

En este caso ya contamos con el ID de Facebook Business (business_id) y con el WABA ID (waba_id) los guardamos.

Y ahora podremos obtener los siguiente datos:


- Identificador de número de teléfono.
- Identificador de la cuenta de WhatsApp Business.


Una vez completados todos estos pasos obtendrás:

- Número de WhatsApp
- Business Id de Facebook
- WABA Id
- Phone Number Id
- Token (Paso 4)

8. Configurar en el Xintel

Una vez que obtengamos los datos necesarios, debemos dirigirnos al xintelweb:
Mantenimiento -> Control del sistema -> Interfaces y completar los datos.

Actualizado el: 27/04/2023