Configurar WhatsApp Business

1. Que pide a páxina

En “Configuración Básica”, un “Nome da Integración” e o “Ambiente”. En “Credenciais”, catro datos de Meta: o “ID do número de teléfono” (paso 4), o “Token de acceso” (paso 5), o “Segredo da aplicación” (paso 6) e o “Token de verificación do webhook”, que inventas ti (paso 7).

Ao gardar con “Gardar Configuración” aparece “Probar Conexión”. Despois, cada usuario activa WhatsApp nas súas preferencias de notificación: a ligazón “Ir a preferencias de notificación” leva alí.

2. Pasos 1 a 3: conta de Meta Business, verificación e app

Paso 1. Entra en business.facebook.com coa túa conta de Facebook e crea un portafolio comercial (nome da empresa, o teu nome e un correo de empresa).

Paso 2. En “Configuración do negocio → Centro de seguridade → Verificación do negocio”, sube o NIF e un xustificante de enderezo. Meta tarda 2-4 días; sen verificar só podes enviar en modo de proba.

Paso 3. En developers.facebook.com → “As miñas apps” → “Crear app”, escolle o caso de uso “Conectar con clientes por WhatsApp”, ponlle nome e asóciaa ao teu portafolio.

3. Pasos 4 a 6: número, token e segredo da app

Paso 4. En “Configuración da API”, no despregable “Desde”, preme “Engadir número de teléfono” e verifícao por SMS ou chamada. O número non pode ter xa WhatsApp instalado. Debaixo aparece o ID do número: cópiao en “ID do número de teléfono”.

Paso 5. O token de “Configuración da API” caduca en 24 h. En “Configuración do negocio → Usuarios do sistema” crea un usuario do sistema administrador, asígnalle a app e a conta de WhatsApp, preme “Xerar token” con caducidade “Nunca” e os permisos whatsapp_business_messaging, whatsapp_business_management e business_management. Cópiao (empeza por EAA…) en “Token de acceso”: só se amosa unha vez.

Paso 6. Na app de Meta, “Configuración → Básica”, preme “Amosar” xunto á clave secreta e cópiaa en “Segredo da aplicación”.

4. Pasos 7 e 8: token de verificación e gardar

Paso 7. Inventa unha cadea longa e aleatoria (32 caracteres ou máis) e escríbea en “Token de verificación do webhook”. Usarala outra vez no paso 9 e ten que coincidir.

Paso 8. Preme “Gardar Configuración” e logo “Probar Conexión”. Se o token e o número son correctos, a integración pasa a activa.

5. Paso 9: o webhook de estado (recomendado)

Serve para que goPrevina saiba se cada mensaxe se entregou ou se leu. Na app de Meta, “WhatsApp → Configuración → Webhooks → Editar”. En “Callback URL” escribe https://<dominio-da-túa-API>/api/v1/whatsapp/webhook e en “Verify token” o mesmo valor do paso 7. Preme “Verificar e gardar” e, en “Campos do webhook”, subscríbete a messages.

6. Paso 10: modelos de mensaxes para copiar e pegar

WhatsApp só deixa enviar modelos aprobados por Meta. Créaos en WhatsApp Manager → “Modelos de mensaxes” → “Crear modelo”, co nome exacto e a categoría indicada, e pega o corpo tal cal (os parámetros {{1}}, {{2}}… van na orde da lista). Meta adoita aprobar os de tipo UTILITY en 24-48 h.

prl_user_invitation — Categoría: UTILITY — Parámetros: recipientName, tenantName, activationUrl

Corpo para copiar: Ola {{1}}, convidáronte a {{2}} en goPrevina. Activa a túa conta aquí: {{3}}

prl_password_reset — Categoría: AUTHENTICATION — Parámetros: recipientName, resetUrl

Corpo para copiar: Ola {{1}}, solicitaches restablecer o contrasinal. Usa esta ligazón: {{2}}

prl_critical_alert — Categoría: UTILITY — Parámetros: alertTitle, alertMessage

Corpo para copiar: ALERTA CRÍTICA: {{1}}. {{2}}

prl_document_expiring — Categoría: UTILITY — Parámetros: documentName, expiryDate, daysRemaining

Corpo para copiar: O documento «{{1}}» caduca o {{2}} (quedan {{3}} días). Revísao en goPrevina.

prl_document_expired — Categoría: UTILITY — Parámetros: documentName, expiryDate

Corpo para copiar: O documento «{{1}}» caducou o {{2}}. Actualízao en goPrevina.

prl_incident_reported — Categoría: UTILITY — Parámetros: incidentNumber, title, location

Corpo para copiar: Novo incidente {{1}}: «{{2}}» en {{3}}. Consúltao en goPrevina.

prl_incident_assigned — Categoría: UTILITY — Parámetros: incidentNumber, title, assignedBy

Corpo para copiar: Asignáronche o incidente {{1}}: «{{2}}» (por {{3}}). Ábreo en goPrevina.

prl_inspection_scheduled — Categoría: UTILITY — Parámetros: inspectionTitle, scheduledDate, location

Corpo para copiar: Inspección programada: «{{1}}» o {{2}} en {{3}}.

prl_inspection_reminder — Categoría: UTILITY — Parámetros: inspectionTitle, dueDate

Corpo para copiar: Recordatorio: a inspección «{{1}}» vence o {{2}}.

prl_training_reminder — Categoría: UTILITY — Parámetros: courseName, sessionDate, location

Corpo para copiar: Recordatorio de formación: «{{1}}» o {{2}} en {{3}}.

prl_medical_appointment — Categoría: UTILITY — Parámetros: appointmentDate, appointmentTime, location

Corpo para copiar: Tes cita de vixilancia da saúde o {{1}} ás {{2}} en {{3}}.

prl_meeting_invitation — Categoría: UTILITY — Parámetros: meetingTitle, meetingDate, organizer

Corpo para copiar: Reunión: «{{1}}» o {{2}}, organiza {{3}}.

prl_notification — Categoría: UTILITY — Parámetros: title, message

Corpo para copiar: {{1}}: {{2}}

prl_generic — Categoría: UTILITY — Parámetros: dynamic

Corpo para copiar: {{1}}