Whatsapp_es

💬

NW WhatsApp Messaging

Extensión para Microsoft Dynamics 365 Business Central — niccoweb.com

v27.0.0.0

📋 Información General

Publisherniccoweb.com

Versión27.0.0.0

Runtime AL16.0

BC Mínimov27.0

APIGraph v17.0

ℹ️ ¿Qué hace esta extensión?

NW WhatsApp Messaging integra Business Central con la WhatsApp Business Cloud API de Meta, permitiendo enviar mensajes directamente desde el ERP sin salir de la aplicación. La comunicación se realiza mediante llamadas HTTP al endpoint de la Graph API, autenticadas con un Bearer Token.

👤 Usuario BC

→

📄 Página BCWhatsApp Send Messages

→

⚙️ CodeunitWhatsApp

→

🌐 Meta Graph APIv17.0

→

📱 WhatsAppDestinatario

✨ Tipos de Mensajes Soportados

📝

Texto

Mensaje de texto plano al teléfono configurado.

🖼️

Imagen

Imagen por URL pública. Admite caption opcional.

🎬

Video

Video por URL pública. Admite caption opcional.

📄

Documento (URL)

Documento accesible por URL con nombre y caption.

📎

Documento (Upload)

Selecciona un archivo local; se sube a Meta y se envía por Media ID.

🎵

Audio

Archivo de audio por URL pública.

📍

Ubicación

Coordenadas GPS con nombre y dirección. Se detectan automáticamente al abrir la página.

👤

Contacto

Tarjeta vCard con nombre y teléfono del contacto.

🏠

Dirección de Cliente

Envía la ficha de dirección de un cliente de Business Central.

🔘

Botones Interactivos

Mensaje con 2 botones personalizables (ej. Aprobar / Rechazar).

⚙️ Configuración Inicial

• 1
  En Business Central, buscar la página WhatsApp Setup.
• 2
  Ingresar el Token de acceso obtenido desde el portal de Meta for Developers. Es un Bearer token de larga duración.
• 3
  Ingresar el Test Phone: número destino en formato internacional sin espacios. Ejemplo: 5491112345678
• 4
  Guardar. La configuración se persiste en la tabla WhatsApp Setup.

🚀 Cómo Enviar un Mensaje

• 1
  Buscar la página WhatsApp Send Messages en Business Central.
• 2
  Completar los campos del grupo correspondiente al tipo de mensaje que se desea enviar.
• 3
  Hacer clic en la acción de la barra superior (ej. Send Text Message, Send Image, etc.).
• 4
  Si el envío es exitoso, BC muestra un mensaje de confirmación. En caso de error, se muestra el código HTTP y la descripción.

📸 Capturas de Pantalla

🔗 Integración con la API de Meta

La extensión utiliza la WhatsApp Business Cloud API mediante llamadas HTTP desde el codeunit WhatsApp (ID 50950).

# Envío de mensajes
POST https://graph.facebook.com/v17.0/{phone-number-id}/messages
Authorization: Bearer <TOKEN>
Content-Type: application/json

# Subida de archivos (Upload & Send)
POST https://graph.facebook.com/v17.0/{phone-number-id}/media
Authorization: Bearer <TOKEN>
Content-Type: multipart/form-data; boundary=...

📌 El proceso de Upload & Send realiza dos llamadas: primero sube el archivo y obtiene un Media ID, luego envía el mensaje referenciando ese ID.

📦 Objetos AL

Tipo	ID	Nombre	Descripción
Table	50950	WhatsApp Setup	Almacena el Token y el teléfono de prueba
Page	50950	WhatsApp Setup	Página de configuración (tipo Card)
Page	50951	WhatsApp Send Messages	Página principal de envío (tipo Document)
Codeunit	50950	WhatsApp	Lógica de negocio e integración con la API
PermSet	50950	whatsapp	Permisos RIMD sobre todos los objetos

🛡️ Permisos

El permission set whatsapp debe asignarse a todos los usuarios que utilicen la extensión:

📊 Table Data — WhatsApp SetupRIMD

🗄️ Table — WhatsApp SetupExecute

⚙️ Codeunit — WhatsAppExecute

📄 Page — WhatsApp Send MessagesExecute

⚙️ Page — WhatsApp SetupExecute

📝 Requisitos Previos

• ✓
  Business Central versión 27.0 o superior.
• ✓
  Cuenta de WhatsApp Business con acceso a la Cloud API de Meta.
• ✓
  Token de acceso válido desde el Meta for Developers Portal.
• ✓
  Phone Number ID registrado en la aplicación de Meta (configurado en el codeunit).

© 2026 niccoweb.com — NW WhatsApp Messaging v27.0.0.0