Conversión de destinos de HTTP en webhooks

Sugerencia: Los destinos de HTTP quedarán obsoletos en febrero de 2022. Si necesita ayuda para convertir los destinos de HTTP existentes, contacte a Atención al cliente de Zendesk.

Acceso rápido: Centro de administración > Aplicaciones e integraciones > Webhooks > Webhooks

Los destinos de HTTP en Zendesk Support serán reemplazados por webhooks, que se crean y administran en el Centro de administración de Zendesk. En el Centro de administración encontrará un proceso de conversión sencillo que se puede usar para convertir los destinos de HTTP en webhooks.

Este artículo contiene las siguientes secciones:

• Acerca de la conversión de destinos en webhooks
• Preparar los destinos de HTTP para su conversión
• Convertir destinos de HTTP en webhooks en el Centro de administración
• Ver el registro de conversión
• Reintentar una conversión
• Revertir la conversión de un webhook para que sea de nuevo un destino

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

Nota: Antes de cambiar a HTTPS o convertir destinos en webhooks, verifique que el servidor contactado por el webhook admita HTTPS. Si realiza la conversión de los destinos a HTTPS o webhooks y su servidor no admite HTTPS, las solicitudes futuras fallarán.

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

1. En el Centro de administración, haga clic en el icono Aplicaciones e integraciones () en la barra lateral y luego seleccione Destinos > Destinos.
2. Busque el destino en la lista y haga clic en Editar.
3. Modifique el valor Url para utilizar https.
4. 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

1. En el Centro de administración, haga clic en el icono Aplicaciones e integraciones () en la barra lateral y luego seleccione Destinos > Destinos.
2. 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

1. En el Centro de administración, haga clic en el icono Aplicaciones e integraciones () en la barra lateral y luego seleccione Webhooks > Webhooks.
2. Haga clic en Empezar.

   Si tiene destinos que se pueden convertir, se le guiará por el proceso de conversión.

3. Haga clic en Administrar destinos para asegurarse de que sus destinos estén preparados para la conversión y luego haga clic en Siguiente.
4. Revise el resumen de los destinos que cumplen los requisitos y haga clic en Convertir destinos.
5. 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.
6. 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

Antes de convertir destinos, es posible que vea varios destinos que serán omitidos, como los destinos creados a partir de integraciones creadas por Zendesk. Eso significa que quedarán intocados durante el proceso de conversión.

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.

El registro de conversión tiene tres pestañas: No se pudo convertir, Convertidos y Convirtiendo. Cada pestaña presenta el número de webhooks en cada estado y un menú de acciones disponibles para cada destino en ese estado.

• 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

1. En el Centro de administración, haga clic en el icono Aplicaciones e integraciones () en la barra lateral y luego seleccione Webhooks > Webhooks.
2. Haga clic en Acciones en la parte superior de la página y luego haga clic en Ver registro de conversión de destinos.
3. Haga clic en la ventana No se pudo convertir y busque el destino que quiera probar de nuevo.
4. Solucione el error relacionado con el destino.
5. 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

Las siguientes son las razones más importantes por las que pueden fallar las conversiones de destinos.

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

Hasta que los destinos de HTTP se vuelvan obsoletos, los destinos que se conviertan en webhooks se pueden revertir a destinos si se detectan problemas.

Nota: Los webhooks nuevos que se creen en el Centro de administración no se pueden convertir en un destino de HTTP. Esto solo se aplica a los destinos que hayan sido convertidos en webhooks.

Para revertir un webhook a un destino

1. En el Centro de administración, haga clic en el icono Aplicaciones e integraciones () en la barra lateral y luego seleccione Webhooks > Webhooks.
2. Haga clic en Acciones en la parte superior de la página y luego haga clic en Ver registro de conversión de destinos.
3. Haga clic en la pestaña Convertidos y busque el webhook que desea revertir a un destino.
4. 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.