Configurar un canal de WhatsApp

Summit Notify se conecta con WhatsApp mediante AWS End User Messaging Social. La aplicación usa una identidad AWS central y cada cuenta lógica selecciona el WABA y el número desde los que se enviará.

Elegir el modelo de cuenta

Modalidad	Cuándo usarla
notify_managed	El cliente utiliza el WABA y número administrados por Notify.
customer_owned	El cliente conserva su propio WABA y número, vinculados a la cuenta AWS operada por Notify.

La modalidad identifica la propiedad comercial. No almacena credenciales AWS por cliente: el proceso de Notify obtiene sus credenciales mediante el rol o identidad configurados en el despliegue.

Requisitos

Antes de registrar la cuenta, reúne estos identificadores desde AWS y Meta:

• región AWS del recurso;
• WABA ID de AWS;
• Origination phone number ID de AWS, con formato phone-number-id-...;
• Meta WABA ID;
• Meta Phone Number ID;
• número visible en formato internacional.

No confundas el Origination Phone Number ID con el número telefónico ni con el Meta Phone Number ID. Los tres valores cumplen funciones diferentes.

Registrar la cuenta

1. Inicia sesión en el panel de Summit Notify.
2. Abre Canales → Cuentas WhatsApp.
3. Selecciona Nueva cuenta WhatsApp.
4. Elige Administrada por Notify o Propiedad del cliente.
5. Completa la región, WABA ID, Origination Phone Number ID y los identificadores de Meta.
6. Mantén onboarding y messaging en estado active solamente cuando el número esté habilitado en AWS.
7. Marca la cuenta como predeterminada si debe usarse cuando la API omita whatsapp_account_id.
8. Guarda la cuenta.

Los campos de límites diarios y mensuales son metadatos administrativos. No reemplazan los límites o controles aplicados por AWS y Meta.

Configurar eventos entrantes

AWS publica mensajes entrantes y cambios de entrega en un topic SNS estándar. El administrador de Notify debe:

1. configurar WHATSAPP_SNS_TOPIC_ARN con el ARN exacto permitido;
2. crear una suscripción HTTPS hacia https://notify.summitexplorerjd.ec/webhooks/aws/sns/whatsapp;
3. permitir que social-messaging.amazonaws.com publique en el topic;
4. esperar la confirmación automática de la suscripción.

El endpoint valida el Topic ARN, la firma y el certificado SNS antes de procesar el evento. No uses el ARN de la suscripción como WHATSAPP_SNS_TOPIC_ARN: usa el ARN del topic.

Adjuntos entrantes

Los enlaces temporales entregados por Meta no se exponen directamente. Cuando el chat necesita una imagen, audio, video o documento, Notify llama a GetWhatsAppMessageMedia, guarda el objeto en S3 y genera una URL firmada de CloudFront de corta duración.

Esta función requiere configuración global del despliegue para S3 y CloudFront. El bucket debe estar en la misma cuenta y región que la WABA. Si no está configurada, el chat no puede convertir el mediaId en un archivo visible.

Continúa con Gestionar conversaciones de WhatsApp o consulta la referencia técnica del canal.