Webhook

En Riversoft® STCP DirectLink, Webhook es el intercambio de documentos con socios por HTTP/HTTPS. Cada lado del intercambio tiene un papel:

Componente	Quién inicia la conexión	Función
Conector Webhook	Riversoft STCP DirectLink (conexión de salida)	Envía los documentos del usuario al endpoint HTTP/HTTPS del socio.
Servicio Webhook DirectLink	El socio (conexión de entrada)	Recibe los documentos que el socio envía a Riversoft STCP DirectLink.

En Webhook, cada conexión lleva los documentos en un solo sentido. Para que el socio también envíe documentos, se conecta al servicio Webhook DirectLink.

Conexiones de salida (conector Webhook)

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      SA["Directorio saida"]
      C[Conector Webhook]
    end
    SA --> C
    C -->|documento y headers| P[Endpoint del socio]

Riversoft STCP DirectLink entrega al endpoint del socio, en una solicitud HTTP/HTTPS, cada documento disponible en el buzón del usuario (directorio saida), por agenda o cuando el operador inicia la conexión en el Riversoft Console Portal. La respuesta del socio queda registrada en el log de la transferencia.

Recurso	Descripción
Endpoint	URL del socio que recibe los documentos.
Identificación	Identificador del remitente y del destinatario del intercambio, definidos en el registro del usuario.
Autenticación	Ninguna, Basic o Bearer, según lo exija el socio, con las credenciales protegidas en el registro.
Firma y cifrado	Firma con el certificado y la clave de Riversoft STCP DirectLink y cifrado con el certificado del socio, con el algoritmo acordado.
Headers personalizados	Headers fijos definidos en el registro del usuario y headers por archivo, informados en los metadatos del archivo.
TLS	Validación del certificado del socio, CA propia y certificado de cliente (mTLS).
Red	La conexión puede salir por un proxy y por una dirección local específica.
Timeout	Tiempo máximo de cada envío.

El conector Webhook solo envía documentos: no lista, no descarga ni elimina archivos en el socio.

Conexiones de entrada (servicio Webhook DirectLink)

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      S[Servicio Webhook DirectLink]
      EN["Directorio entrada"]
    end
    Q[Sistema del socio] -->|documento y autenticación| S
    S --> EN

El socio envía documentos al endpoint del servicio Webhook DirectLink. Cada solicitud se autentica, se asocia a un usuario y se graba en el directorio entrada de su buzón.

Autenticación	Validación
Ninguna	Solo para entornos controlados.
Basic	Usuario y contraseña de Riversoft STCP DirectLink.
Bearer	Solo token de impersonación registrado para el usuario; el `sub` del token debe corresponder a la identificación del socio.

Además de la credencial, el destinatario informado en la solicitud (header X-To) debe corresponder a la identificación registrada para el socio. El servicio acepta TLS con versión mínima y máxima configurables y autenticación de cliente por certificado (mTLS).

El servicio Webhook DirectLink se registra en los servicios de red de la instancia, en el Riversoft Console Portal: dirección, puerto, TLS y la dirección pública del servicio.

Qué acordar con el socio

Elemento	Descripción
Direcciones	URL del endpoint del socio y URL pública del servicio Webhook DirectLink.
Identificaciones	Identificadores del remitente y del destinatario en los dos sentidos.
Autenticación	Basic o Bearer, en los dos sentidos.
Certificados	Certificados de firma y de cifrado, cuando se usen, y los algoritmos.
Headers	Headers que el socio espera recibir.

Seguridad

Publique el servicio Webhook DirectLink solo por HTTPS y, siempre que sea posible, exija mTLS del socio.
Prefiera Bearer con token de impersonación o Basic a ninguna autenticación; guarde las credenciales en un almacén de secretos.
Use firma y cifrado cuando el socio los admita.
Mantenga habilitada la validación del certificado del socio en el conector.

SFTP WhatsApp