Acerca de la conversión de destinos en webhooks
Tenga en cuenta lo siguiente antes de convertir los destinos.
- La herramienta de conversión solo convierte destinos de HTTP.
- Los destinos tienen que estar activos para poder convertirse. Los destinos que estén desactivados no podrán convertirse.
- Los webhooks no admiten la autenticación de HTTP. Los destinos que utilicen autenticación deberán actualizarse para que usen HTTPS antes de ser convertidos.
- Se convertirán todos los destinos que cumplan los requisitos. No es posible convertir un destino a la vez.
- Los destinos seguirán activos hasta después de su conversión o hasta que los destinos de HTTP se vuelvan obsoletos.
- Si falla alguna parte de la conversión, se revertirá todo lo relacionado con los destinos que no se convirtieron. Una conversión fallida no debería afectar en ningún caso las configuraciones existentes de los disparadores y las reglas de negocio.
- La conversión se puede revertir por completo hasta que los destinos de HTTP se vuelvan obsoletos. Si por cualquier motivo se desea revertir un destino convertido, es posible hacerlo.
Preparar los destinos de HTTP para su conversión
Existen dos casos en los que los destinos no se pueden convertir:
- Los destinos usan HTTP en lugar de HTTPS y tienen activada la autenticación básica
- Los destinos están inactivos
En la mayoría de los casos, existen maneras sencillas de modificar los destinos para que puedan incluirse en la conversión.
Cambiar de HTTP a HTTPS
Durante el proceso de conversión podrá elegir entre convertir destinos no seguros en webhooks seguros (HTTPS) o no. Si elige convertir destinos no seguros, no es necesario que haga nada con antelación.
Si desea convertir solamente algunos de los destinos de HTTP que usan HTTP, puede actualizar manualmente los URL que corresponden solo a esos destinos y luego seleccionar la opción para no convertir los destinos no seguros durante el proceso de conversión.
Para cambiar un URL de destino de HTTP a HTTPS
- En el Centro de administración, haga clic en el icono Aplicaciones e integraciones (
) en la barra lateral y luego seleccione Destinos > Destinos.
- Busque el destino en la lista y haga clic en Editar.
- Modifique el valor Url para utilizar https.
- Seleccione Actualizar destino en el menú desplegable y haga clic en Enviar.
Asegurarse de que los destinos están activos
La conversión solo admite destinos de HTTP activos.
Para activar un destino
- En el Centro de administración, haga clic en el icono Aplicaciones e integraciones (
) en la barra lateral y luego seleccione Destinos > Destinos.
- Busque el destino que desea reactivar en la lista Destinos inactivos y haga clic en activar.
Convertir destinos de HTTP en webhooks en el Centro de administración
El proceso de conversión comienza con la clonación de todos los destinos existentes. Luego se modifican las reglas de negocio para usar webhooks en lugar de destinos. El último paso es desactivar los destinos y activar los webhooks.
Si la conversión se realiza correctamente, los destinos de HTTP se desactivan, los webhooks se activan y las reglas de negocio se actualizan casi simultáneamente.
Si la conversión de un destino falla, el destino y los disparadores correspondientes permanecerán activos y sin cambios.
Para convertir destinos de HTTP en webhooks
- En el Centro de administración, haga clic en el icono Aplicaciones e integraciones (
) en la barra lateral y luego seleccione Webhooks > Webhooks.
- Haga clic en Empezar.
Si tiene destinos que se pueden convertir, se le guiará por el proceso de conversión.
- Haga clic en Administrar destinos para asegurarse de que sus destinos estén preparados para la conversión y luego haga clic en Siguiente.
- Revise el resumen de los destinos que cumplen los requisitos y haga clic en Convertir destinos.
- Si se detectan destinos (HTTP) no seguros, puede optar por convertir destinos no seguros en webhooks (HTTPS) seguros o no convertir destinos no seguros.
Nota: La conversión de destinos no seguros en webhooks seguros podría romper los flujos de trabajo si el servidor no admite HTTPS.
- Haga clic en Ver registro de conversión de destinos para ver qué destinos se convirtieron correctamente, así como los que fallaron.
Destinos omitidos durante la conversión
- Los destinos fueron creados a partir de integraciones, como la de Salesforce
Ver el registro de conversión
Al final del proceso de conversión, hay una invitación para ver el registro de conversión. También se puede acceder a él en cualquier momento desde la página Webhooks. Para ver el registro de conversión, haga clic en Acciones en la parte superior de la página y luego haga clic en Ver registro de conversión de destinos.
- La pestaña Convirtiendo solo tiene contenido durante el proceso de conversión. Debería estar vacía la mayor parte del tiempo.
- La pestaña Convertidos muestra un registro de todos los webhooks que se convirtieron correctamente. En esta pestaña es posible ver un webhook en más detalle, revertir un webhook de nuevo a un destino y buscar la ID de conversión de un webhook determinado.
- La pestaña No se pudo convertir muestra un registro de cada destino que cumple los requisitos pero que no se convirtió correctamente. Utilice esta pestaña para ver los detalles de por qué falló la conversión y volver a intentar la conversión de cada destino.
Reintentar una conversión
En el registro de conversión se ven los destinos que no se pudieron convertir y se puede reintentar la conversión.
Para reintentar la conversión de un destino
- En el Centro de administración, haga clic en el icono Aplicaciones e integraciones (
) en la barra lateral y luego seleccione Webhooks > Webhooks.
- Haga clic en Acciones en la parte superior de la página y luego haga clic en Ver registro de conversión de destinos.
- Haga clic en la ventana No se pudo convertir y busque el destino que quiera probar de nuevo.
- Solucione el error relacionado con el destino.
- Haga clic en el icono Menú de opciones (
) en la fila del destino y haga clic en Volver a intentar la conversión.
Mientras se reintenta la conversión, el destino aparecerá en la pestaña Convirtiendo. Una vez finalizado el reintento de conversión, el destino se traslada a la pestaña Convertidos o se actualiza la información sobre la conversión fallida en la pestaña No se pudo convertir y el destino se mueve a la parte superior de la tabla.
Resolver errores de conversión
Error | Razón | Corrección |
---|---|---|
Error al actualizar el disparador | Falló la actualización del destino que invoca al webhook. Por lo general, esto se debe a una configuración no válida del disparador, algo que no tiene nada que ver con la conversión. | Revise los disparadores para asegurarse de que se puedan modificar y guardar, y trate de hacer la conversión nuevamente. |
Error al actualizar el destino | Falló la actualización para desactivar el destino de HTTP. Esto generalmente se debe a una configuración no válida del destino, como un URL de destino no válido. | Revise los destinos de HTTP para asegurarse de que se puedan modificar y guardar, y trate de hacer la conversión nuevamente. |
Error al actualizar el webhook | No se creó el webhook debido a problemas de validación. | Revise los destinos HTTP para asegurarse de que estén correctamente preparados para la conversión y trate de hacer la conversión nuevamente. |
Revertir la conversión de un webhook para que sea de nuevo un destino
Para revertir un webhook a un destino
- En el Centro de administración, haga clic en el icono Aplicaciones e integraciones (
) en la barra lateral y luego seleccione Webhooks > Webhooks.
- Haga clic en Acciones en la parte superior de la página y luego haga clic en Ver registro de conversión de destinos.
- Haga clic en la pestaña Convertidos y busque el webhook que desea revertir a un destino.
- Haga clic en el icono del menú de acción (
) y luego en Revertir a destino.
Una vez que el webhook se revierte correctamente a destino, se elimina de la lista en la pestaña Convertidos.
0 Comentarios
Inicie sesión para dejar un comentario.