Wiki

Obten tus credenciales Meta para Homenichat

Para conectar tu numero de WhatsApp oficial a Homenichat, necesitas cuatro credenciales generadas en Meta. Esta pagina te guia paso a paso, desde la cuenta Meta Business hasta el pegado final en el asistente de Homenichat. Si te atascas en algun paso, puedes contactarnos y te acompanamos.

Lo que obtendras al final Cuatro valores para pegar en el asistente de Homenichat: phoneNumberId, businessAccountId, accessToken y verifyToken (generado por Homenichat). Mas una callbackUrl para copiar en Meta. Cuenta unos 30 a 45 minutos la primera vez.

Antes de empezar: requisitos previos

Una direccion de correo profesional

Para la cuenta Meta Business. Usa la direccion que quieres asociar a tu empresa.

Un telefono con WhatsApp Business

La app WhatsApp Business instalada y activa en el numero que quieras usar.

Una cuenta personal de Facebook

Meta Business esta vinculado a tu cuenta de Facebook (se usa solo para administracion, no se publica nada).

Una tarjeta o cuenta bancaria

Meta puede pedir un metodo de pago antes de ciertos envios API (a menudo cero euros al final).

Tu HomeniBOX ya instalada

La BOX debe estar online en el momento de la conexion final. Si todavia no tienes una box, ver la pagina de material.

30 a 45 minutos por delante

Sin interrupcion, ideal para hacer todo el recorrido de una sola vez.

Importante Si tu numero de WhatsApp esta actualmente usado en la app WhatsApp Business del telefono, tendras que elegir entre seguir usandolo solo en el telefono o conectarlo a Homenichat via la API oficial. Meta esta trabajando en un modo "coexistencia" que permitira ambos, pero Homenichat aun no lo ha activado. Si quieres mantener la app del telefono por ahora, usa un segundo numero para esta configuracion.

Vision general del recorrido

Crear una cuenta Meta Business (Meta Business Suite).
Crear un portafolio business (Business Portfolio).
Anadir tu numero de WhatsApp al portafolio (creacion del WABA).
Verificar tu empresa (opcional, recomendado).
Crear una app Meta Developer y anadir el producto WhatsApp.
Generar un access token (System User permanente o temporal).
Recuperar el phone_number_id y el business_account_id.
Lanzar el asistente de Homenichat que te da la callback URL y el verify token.
Pegar la callback URL y el verify token en Meta, despues validar.
Probar un mensaje entrante para confirmar que todo funciona.

Procedimiento paso a paso

1

Crear una cuenta Meta Business

⏱ 5 min🔗 business.facebook.com

Ve a business.facebook.com y conectate con tu cuenta personal de Facebook. Haz clic en "Crear cuenta" si todavia no tienes una. Rellena el nombre de tu empresa y tu correo profesional.

Captura proxima: pantalla de bienvenida de Meta Business Suite con el boton "Crear cuenta"

Consejo Tu cuenta personal de Facebook solo sirve para autenticarte. Tus clientes nunca la veran. No necesitas publicar nada en Facebook.

2

Crear o verificar tu portafolio business

⏱ 2 min

En Meta Business Suite, en Configuracion > Configuracion de la empresa > Cuentas > Grupo de activos empresariales (el menu varia segun la version de Meta del momento), asegurate de que se haya creado un portafolio business para tu empresa. Anotalo. Es ahi donde vamos a vincular el numero de WhatsApp.

Captura proxima: pagina Configuracion de la empresa, seccion Activos empresariales

3

Anadir tu numero de WhatsApp (creacion del WABA)

⏱ 10 min📩 SMS de verificacion recibido

Siempre en Configuracion de la empresa, ve a Cuentas > Cuentas de WhatsApp. Haz clic en Anadir, despues Crear una cuenta de WhatsApp Business. Sigue el asistente de Meta. Al final, Meta enviara un codigo de verificacion a tu numero (SMS o llamada) para confirmar que es realmente tuyo.

Captura proxima: creacion del WABA, paso numero de telefono

Si Meta dice que tu numero ya esta en uso Significa que esta vinculado a la app WhatsApp Business de tu telefono. Tendras que desconectarlo de la app primero. Para hacerlo: abre WhatsApp Business en el telefono, ve a Configuracion > Cuenta > Eliminar mi cuenta (esta accion pausa temporalmente el numero), o contacta con el soporte de Meta para migrar.

4

Verificar tu empresa (recomendado, no obligatorio para empezar)

⏱ 5 min para enviar, varios dias de validacion Meta

En Configuracion de la empresa > Verificacion de la empresa, sigue el procedimiento. Meta te pedira documentos (registro mercantil, justificante de domicilio, eventualmente una videollamada). Puedes usar la API sin verificacion inmediata (con limites de volumen), pero la verificacion es necesaria para las conversaciones marketing y los volumenes altos.

Captura proxima: formulario de verificacion empresarial

5

Crear una app Meta Developer y anadir WhatsApp

⏱ 5 min🔗 developers.facebook.com/apps

Ve a developers.facebook.com/apps. Haz clic en "Crear app". Elige el tipo "Business". Dale un nombre (por ejemplo: "WhatsApp Homenichat - Mi clinica"), vinculala a tu Business Portfolio creado en el paso 2.

Una vez creada la app, en el menu de la izquierda haz clic en "Anadir producto" y elige WhatsApp. Sigue el asistente. Meta te pedira seleccionar tu WABA (creado en el paso 3).

Captura proxima: Meta Developer Console con "Anadir producto > WhatsApp"

6

Recuperar phoneNumberId y businessAccountId

⏱ 2 min

En tu app Developer, ve a WhatsApp > API Setup. Veras:

Campo Meta	Donde se usa en Homenichat
Phone number ID	phoneNumberId
WhatsApp Business Account ID	businessAccountId

Copia estos dos valores en un borrador mientras tanto. Son numeros (por ejemplo 589510807587130).

Captura proxima: pagina "WhatsApp > API Setup" con los dos IDs destacados

7

Generar un Access Token permanente (System User)

⏱ 8 min🔑 A hacer solo una vez

El token temporal mostrado por defecto en la pagina WhatsApp API Setup expira a las 24 horas. Para un uso duradero, hay que crear un System User que posea un token permanente.

En Configuracion de la empresa, ve a Usuarios > Usuarios del sistema.
Haz clic en "Anadir", dale un nombre (por ejemplo: "WhatsApp Integrator Homenichat"), elige el rol "Administrador".
Una vez creado, haz clic en "Anadir activos", anade tu WABA con permisos completos.
Haz clic en "Generar token". Elige tu app Meta Developer (paso 5).
Marca los permisos: whatsapp_business_management y whatsapp_business_messaging.
Selecciona "El token nunca expira".
Copia inmediatamente el token mostrado. Empieza por EAA.... Meta no lo volvera a mostrar nunca mas.

Captura proxima: Configuracion de la empresa > Usuarios del sistema > generacion del token con permisos marcados

Guarda el token inmediatamente. Ponlo en un gestor de contrasenas o en un lugar seguro. Si lo pierdes, tendras que regenerar uno nuevo (lo que invalidara el antiguo).

8

Recuperar el App Secret (opcional pero recomendado)

⏱ 1 min

En Meta Developer Console, dentro de tu app, ve a Configuracion > General. Haz clic en "Mostrar" al lado de "Secreto de la app". Copia el valor.

Esta clave sirve al relay de Homenichat para verificar que los webhooks recibidos vienen realmente de Meta (firma HMAC). Sin ella, los webhooks funcionan pero sin verificacion de firma.

Captura proxima: Configuracion > General con el App Secret mostrado

9

Lanzar el asistente de Homenichat en tu telefono

⏱ 2 min

Abre la app Homenichat, ve a Configuracion > WhatsApp oficial Meta. Toca "Configuracion Meta asistida" y sigue las pantallas.

Cuando llegues a la pantalla "Configura el webhook en Meta", Homenichat te muestra dos valores para copiar en Meta:

La Callback URL publica. Tiene la forma https://webhooks.homenichat.com/meta/<tu-id>.
Un Verify Token generado por Homenichat (cadena de caracteres aleatoria). Meta lo usa para validar que eres tu quien configura el webhook.

Toca "Copiar" en cada campo, o anota los valores.

Captura proxima: pantalla "Webhook setup" en la app Homenichat con los dos botones Copiar

10

Conectar el webhook en Meta

⏱ 3 min

Vuelve a Meta Developer Console > tu app > WhatsApp > Configuracion > Webhooks. Haz clic en "Configurar un webhook".

En Callback URL, pega el valor de Homenichat.
En Verify Token, pega el token generado por Homenichat.
Haz clic en "Verificar y guardar". Meta envia una solicitud de verificacion a Homenichat; tarda unos segundos.

Si Meta dice "Verificado", perfecto. Si no, comprueba que has pegado los valores correctos (sin espacios) y que tu HomeniBOX esta online.

Despues, en "Campos del webhook", suscribete al menos a: messages, message_template_status_update, account_update.

Captura proxima: pagina "Webhooks" en Meta Developer con callback URL y verify token pegados

11

Pegar las credenciales en el asistente de Homenichat

⏱ 2 min

Vuelve al asistente de Homenichat en tu telefono, pasa a la pantalla "Introduce tus credenciales Meta" y pega:

Campo Homenichat	Valor a pegar
phoneNumberId	Recuperado en el paso 6
businessAccountId	Recuperado en el paso 6
accessToken	Token EAA... del paso 7
appSecret	Recuperado en el paso 8 (opcional)

Toca "Verificar".

12

Validacion final

⏱ 1 min

Homenichat lanza tres verificaciones automaticamente:

Conexion Meta Graph API: prueba que tu token es correcto.
Listado de plantillas: verifica que puedes enviar/recibir plantillas.
Activacion del relay: Homenichat registra tu callback URL para transmitir los webhooks Meta a tu BOX.

Tres luces verdes? Terminado. Tus mensajes de WhatsApp llegaran a Homenichat desde el proximo mensaje del cliente.

Prueba recomendada Pide a alguien (tu pareja, un amigo) que envie un WhatsApp a tu numero profesional desde su propio WhatsApp. El mensaje debe aparecer en la bandeja de entrada de Homenichat en un segundo. Si no llega nada en 30 segundos, ver la seccion de solucion de problemas mas abajo.

Resumen de los valores recogidos

Las 4 credenciales Meta

phoneNumberId	numero, ej: 589510807587130
businessAccountId	numero, ej: 578793621992297
accessToken	cadena larga que empieza por EAA...
appSecret	cadena hex de 32 caracteres (opcional)

Solucion de problemas

Meta rechaza mi callback URL ("Verificacion fallida")

Comprueba que tu HomeniBOX esta online (el indicador debe estar verde).
Comprueba que has pegado el verify token SIN espacios antes ni despues.
Genera una nueva sesion en la app Homenichat y vuelve a intentar la conexion.
Si persiste: contactanos, podemos diagnosticar el paso del challenge desde nuestros servidores.

El access token es rechazado con "Invalid OAuth access token"

Comprueba que has usado el token System User permanente (paso 7), no el token temporal que expira en 24 horas.
Comprueba que el System User tiene los dos permisos whatsapp_business_management y whatsapp_business_messaging.
Comprueba que tu System User tiene tu WABA en sus activos, con permisos completos.

Ningun mensaje entrante llega a Homenichat

Comprueba que estas suscrito al campo messages en los Webhooks Meta (paso 10).
Comprueba en la app que la box esta online.
Pide a Meta que reenvie un evento de prueba: Meta Developer Console > Webhooks > "Probar".

Meta pide un metodo de pago antes de que pueda enviar

Es normal para las conversaciones marketing y mas alla de 1000 conversaciones service al mes. En Configuracion de la empresa > Pagos, anade una tarjeta o una cuenta bancaria. No te facturan si te quedas dentro del gratuito. Homenichat nunca factura tus mensajes: es Meta quien cobra, directamente.

Necesitas ayuda?

Si te atascas, escribenos a support@homenichat.com. Danos el paso que bloquea y un screenshot del mensaje de error si es posible. Te acompanamos. Para los usuarios Team (9 euros/mes), esta asistencia es prioritaria.

Necesitas la HomeniBOX antes?

Sin box, el wizard no podra activar el relay del webhook al final. Ver nuestras configuraciones de material.

Configuraciones de material