Skip to content

Enviar notificaciones mediante tu propio proveedor

Declara el proveedor propio de correo, SMS o WhatsApp de tu tenant, dale su credencial, pruébalo y habilítalo, para que las notificaciones de la plataforma a tus personas se envíen mediante tu cuenta.

Quién puede hacerlo

Un administrador del tenant, o un superadministrador de plataforma que trabaja dentro de tu tenant. La consola ofrece los controles de escritura solo a quien tiene el permiso para gestionar los proveedores de entrega del tenant; ejecutar una prueba necesita su propio permiso.

Antes de empezar

  • La edición de tu tenant incluye los proveedores de entrega propios. Cuando no los incluye, el panel lo indica y no ofrece ningún control de escritura. En un despliegue operado por el cliente, además, el operador de la plataforma debe haber delegado los proveedores de entrega a tu tenant.
  • Ten lista la cuenta del proveedor. Los mecanismos admitidos son SMTP, SendGrid, Microsoft Graph y Gmail para el correo, Twilio SMS para SMS y Twilio WhatsApp para WhatsApp.
  • Un tenant tiene como máximo un proveedor de cada mecanismo. Los mensajes de un canal se intentan en orden: primero el principal y luego cada respaldo.

Pasos

  1. Abre Configuración y selecciona la pestaña Integraciones.
  2. En la fila Proveedores de entrega, selecciona Gestionar. El panel se abre sobre la página.
  3. Elige la pestaña del canal: Correo, SMS o WhatsApp.
  4. Selecciona Agregar proveedor. En el diálogo:
    1. Mecanismo: el tipo de proveedor de ese canal.
    2. Posición: Principal o una posición de respaldo en la cadena del canal.
    3. Completa los campos de transporte y de remitente que pide el mecanismo, como el host y el puerto del relay para SMTP, o el número remitente para Twilio.
  5. Selecciona Guardar cambios. La consola valida la configuración antes de guardar nada.
  6. En la fila del proveedor nuevo, selecciona Credencial, escribe el Secreto (o, para Gmail, el Documento de clave de la cuenta de servicio) y selecciona Sellar credencial.
  7. Selecciona Probar. La prueba comprueba que el proveedor se autentica y que se puede contactar; no envía ningún mensaje a un destinatario real.
  8. Cuando la prueba se aprobó, selecciona Habilitar.

Para cambiar un proveedor más adelante, usa Editar, Deshabilitar o Eliminar credencial en su fila.

Qué ves cuando funcionó

La prueba termina con Prueba aprobada, y la columna Última prueba de la fila muestra Aprobada. Después de Habilitar, el Estado de la fila es Activo y el proveedor ocupa su lugar en la cadena del canal. Una prueba aprobada demuestra que el proveedor se autenticó y que se pudo contactar, no que un mensaje se vaya a entregar.

Cada declaración, cambio y eliminación se escribe en tu registro de auditoría.

Si falla

Qué ves Causa Qué hacer
Habilitar no está disponible: "Ejecuta una prueba contra la configuración actual antes de habilitar este proveedor." El proveedor no tiene una prueba aprobada vigente Ejecuta Probar y habilítalo cuando se apruebe
Prueba fallida, con el motivo del proveedor No se pudo contactar al proveedor, o rechazó la credencial Corrige la configuración o la credencial y vuelve a probar
"Incluido en la edición Enterprise" La edición de tu tenant no incluye los proveedores de entrega propios Contacta a tu gestor de cuenta
Se rechaza la declaración porque el tenant ya declara ese mecanismo Un proveedor por mecanismo Edita el proveedor existente
Se rechaza la credencial por no ser válida Está vacía, es demasiado larga, o a un documento de clave de Gmail le falta un miembro que necesita Pega el valor completo exactamente como se emitió
Un proveedor de WhatsApp no se puede habilitar, nombrando tipos de notificación No hay ninguna plantilla aprobada asociada a esos tipos Asocia una plantilla aprobada a cada tipo de la lista y luego habilítalo
Después de cambiar o quitar una credencial, el proveedor vuelve a Declarado Cambiar o quitar una credencial descarta su resultado de prueba Dale una credencial, pruébalo y vuelve a habilitarlo

Twilio SMS y Twilio WhatsApp comparten una misma credencial guardada: quitarla mediante cualquiera de los dos proveedores la quita de ambos.

Sin la consola

Superficie Cómo
API POST /api/v3/admin/tenants/{tenantId}/notification/providers/validate (validateNotificationProviderConfig), luego POST /api/v3/admin/tenants/{tenantId}/notification/providers (declareNotificationProvider)
API PUT .../notification/providers/{id} (replaceNotificationProviderConfig), PUT .../providers/{id}/credential (replaceNotificationProviderCredential), DELETE .../providers/{id}/credential (deleteNotificationProviderCredential)
API POST .../providers/{id}/test (testNotificationProvider), POST .../providers/{id}/enable (enableNotificationProvider), DELETE .../providers/{id}/enable (disableNotificationProvider)

Relacionado