WhatsApp

Riversoft® STCP DirectLink usa la WhatsApp Business Platform, de Meta, para entregar documentos a personas por WhatsApp y para recibir los documentos que ellas envían de vuelta.

Componente	Quién inicia la conexión	Función
Conector WhatsApp	Riversoft STCP DirectLink (conexión de salida)	Envía documentos, enlaces seguros y PIN al celular del destinatario.
Servicio WhatsApp DirectLink	Meta (conexión de entrada)	Recibe los documentos que los contactos envían por WhatsApp y los graba en el buzón.

Conexiones de salida (conector WhatsApp)

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      SA["Directorio saida"]
      C[Conector WhatsApp]
    end
    SA --> C
    C -->|documento o enlace| M[WhatsApp Business Platform]
    M --> W[Celular del destinatario]

Riversoft STCP DirectLink envía los documentos disponibles en el buzón del usuario (directorio saida), por agenda o cuando el operador inicia la conexión en el Riversoft Console Portal. El destinatario viene del nombre del archivo, en el formato <celular>@<nombre-del-archivo>: el número es la parte antes del primer @.

Modo de entrega	Qué recibe el destinatario
Documento	El propio archivo, como documento de WhatsApp.
Enlace de Meta	Un enlace para descargar el archivo, alojado por Meta.
Enlace seguro	Un botón con el enlace seguro de Riversoft STCP DirectLink para descargar el archivo.
Enlace seguro con PIN	El botón con el enlace seguro y un PIN, exigido en la descarga.

Los mensajes usan los templates aprobados para la cuenta en Meta. El conector WhatsApp solo envía: no busca archivos.

Conexiones de entrada (servicio WhatsApp DirectLink)

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      S[Servicio WhatsApp DirectLink]
      EN["Directorio entrada"]
    end
    W[Celular del contacto] -->|documento| M[WhatsApp Business Platform]
    M -->|webhook| S
    S --> EN

Cuando un contacto envía un documento al número de WhatsApp de la empresa, Meta avisa al servicio WhatsApp DirectLink (webhook). El servicio descarga el documento y lo graba en el directorio entrada del buzón del usuario, con el nombre <celular>@<nombre-del-documento>, para identificar a quién lo envió.

El servicio WhatsApp DirectLink se registra en los servicios de red de la instancia, en el Riversoft Console Portal, con la dirección pública del webhook, las credenciales de la aplicación en Meta y el directorio de los templates.

Qué preparar en Meta

Elemento	Descripción
Cuenta	Cuenta de WhatsApp Business, con el número de teléfono de la empresa.
Aplicación	Aplicación en Meta, con el secreto de la aplicación y un token de credencial de sistema.
Webhook	URL pública del servicio WhatsApp DirectLink y el token de verificación, registrados en la aplicación.
Templates	Templates de mensaje aprobados para los modos de entrega usados.

El registro del usuario en el Riversoft Console Portal guarda el ID del número de teléfono, el token de credencial y el modo de entrega.

Seguridad

Para documentos sensibles, prefiera el enlace seguro con PIN: el archivo no queda en la conversación y la descarga exige el código.
Publique el servicio WhatsApp DirectLink solo por HTTPS.
Guarde el secreto de la aplicación y los tokens de Meta como credenciales.

Webhook