¿Qué plan tengo?

Disponible en todos los planes de Suite

Disponible en todos los planes de Support

Nota: Los destinos de marca y URL quedarán obsoletos a partir del 13 de diciembre de 2024. Si desea más información, consulte el anuncio.

Anteriormente, los destinos se usaban para pasar información a aplicaciones y servicios externos basados en la nube para notificarles sobre cambios en Zendesk. En este artículo se describe cómo convertir la mayoría de los destinos existentes en webhooks.

Este artículo contiene los siguientes temas:
  • Crear un nuevo webhook a partir de un destino
  • Configurar un disparador para enviar notificaciones al webhook
  • Desactivar un destino y los disparadores asociados

Acerca de la conversión de destinos en webhooks

Al convertir los destinos en webhooks, el orden de las acciones es importante para la continuidad del proceso. Se recomienda el siguiente proceso:
  1. Crear un nuevo webhook a partir de un destino.
  2. Configurar un disparador para enviar la notificación al webhook.
  3. Verificar que el nuevo webhook y el disparador estén funcionando como es debido y luego desactivar el destino y todos los disparadores asociados con el destino.

Convertir destinos Clickatell, Pivotal, Twilio, X Corp y Yammer

No existe una manera directa de mapear las configuraciones de los destinos Clickatell, Pivotal, Twilio, X Corp (anteriormente Twitter) y Yammer en webhooks. Se recomienda ver si hay aplicaciones en el Marketplace de Zendesk que satisfagan sus necesidades.

Crear un nuevo webhook a partir de un destino

Para convertir sus destinos en webhooks, lo mejor es tener los detalles del destino abiertos en una ventana y el webhook abierto en otra.

Para crear un webhook a partir de un destino de URL

  1. En una ventana de navegador, abra el destino de URL.
    1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Destinos > Destinos.
    2. Ubique el destino que desea convertir en un webhook y haga clic en Editar.
  2. En una ventana de navegador separada, abra la página Webhooks.
    • En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones y webhooks > Webhooks.
  3. Haga clic en Crear webhook.
  4. Seleccione Disparador o automatización como manera de conexión y haga clic en Siguiente.
  5. Mapee los valores del destino con los campos del webhook. Para ver instrucciones detalladas sobre el mapeo, consulte:
    • Basecamp
    • Campfire
    • Get Satisfaction
    • Jira
    • URL
  6. Haga clic en Crear webhook.

Mapear configuraciones del destino Basecamp con webhooks

Mapee los valores del destino Basecamp con los campos del webhook como sigue:
  • Título: el Nombre del webhook.
  • URL: el URL de extremo del webhook.
  • Para la autenticación del webhook, elija uno de los siguientes métodos:
    • Nombre de usuario y Contraseña: establezca la Autenticación del webhook en Autenticación básica e ingrese el nombre de usuario y la contraseña de Basecamp. La contraseña no se puede copiar y pegar.
    • Token de API: establezca la Autenticación del webhook en Clave API e ingrese el token de API del destino Campfire.
  • ID de proyecto: anexe /projects/[ID] al final del URL de extremo del webhook. Por ejemplo: https://corp.basecamphq.com/projects/2612430.
  • Recursos: anéxelo al final del URL de extremo del webhook, después de la ID del proyecto.
    • Mensaje: anexe /posts/[ID]/comments. Ejemplo: https://corp.basecamphq.com/projects/2612430/posts/25611692/comments
    • Tarea: anexe /todo_lists/[ID]. Ejemplo: https://corp.basecamphq.com/projects/2612430/todo_lists/25611692.

Mapear configuraciones del destino Campfire con webhooks

Mapee los valores del destino Campfire con los campos del webhook como sigue:
  • Título: el Nombre del webhook.
  • Subdominio: el URL de extremo del webhook.
  • Token de API: establezca la Autenticación del webhook en Clave API e ingrese el token de API del destino Campfire.
  • Sala: anexe esta información al URL de extremo del webhook.
  • SSL: esto no se aplica cuando se crea un webhook.
  • Conservar formato: esto no se aplica cuando se crea el webhook.

Mapear configuraciones del destino Get Satisfaction con webhooks

Mapee los valores del destino Get Satisfaction con los campos del webhook como sigue:
  • Título: el Nombre del webhook.
  • Nombre de la compañía: se debe incorporar en el URL de extremo del webhook. Por ejemplo: https://getsatisfaction.com/yourcompany/
  • Correo electrónico y Contraseña: establezca la Autenticación del webhook en Autenticación básica e ingrese el nombre de usuario y la contraseña de Get Satisfaction. La contraseña no se puede copiar y pegar.

Mapear configuraciones del destino Jira con webhooks

Zendesk recomienda encarecidamente usar la aplicación de Jira del Marketplace de Zendesk para reemplazar los destinos Jira. Sin embargo, si opta por no usar la aplicación de Jira, puede mapear los valores del destino Jira con los campos del webhook como sigue:
  • Título: el Nombre del webhook.
  • URL: el URL de extremo del webhook.
  • Nombre de usuario y Contraseña: establezca la Autenticación del webhook en Autenticación básica e ingrese el nombre de usuario y la contraseña de Jira. La contraseña no se puede copiar y pegar.

Mapear configuraciones del destino de URL con webhooks

Mapee los valores del destino de URL con los campos del webhook como sigue:
  • Título: el Nombre del webhook.
  • URL: el URL de extremo del webhook.
  • Método: el Método de solicitud del webhook.
  • Nombre de atributo: esto no es obligatorio para crear el webhook, pero se utilizará para configurar las acciones del disparador.
  • Autenticación básica: establezca la Autenticación del webhook en Autenticación básica e ingrese el nombre de usuario y la contraseña del destino de URL. La contraseña no se puede copiar y pegar.
  • Además, en el webhook debe establecer el Formulario de solicitud en Codificación de formulario.

Configurar un disparador para enviar notificaciones al webhook

Ya debería tener un disparador configurado para enviar notificaciones según el destino. Puede editar o clonar este disparador, o bien crear uno nuevo.

Para editar un disparador existente para enviar la notificación al webhook
  1. En el Centro de administración, haga clic en Objetos y reglas en la barra lateral y luego seleccione Reglas de negocio > Disparadores.
  2. Edite o clone un disparador existente.

    Observe el valor de Mensaje para la acción Notificar por > Destino. Lo volverá a utilizar con la nueva acción basada en el webhook.

  3. En Acciones, haga clic en Agregar acción y seleccione Notificar por > Webhook activo.
  4. En el menú desplegable, seleccione el webhook que creó para reemplazar el destino.
  5. Configure el webhook para que envíe la información que se necesita enviar.

    Por ejemplo, si desea reemplazar un destino de URL en Parámetros de URL, tiene que hacer lo siguiente:

    • Establezca la clave en el Nombre de atributo del destino de URL.
    • Establezca el valor en el Mensaje de la acción Notificar por > Destino.
  6. Haga clic en Guardar.
  7. Regrese al webhook y pruebe la funcionalidad.

Desactivar un destino y los disparadores asociados

Después de crear el webhook y actualizar el disparador asociado, pruebe el webhook exhaustivamente iniciando las condiciones de disparador correspondientes. Mientras el disparador esté configurado con dos acciones Notificar por, una para el destino y otra para el webhook, debería recibir mensajes duplicados en su aplicación o sistema externo.

Una vez que haya confirmado que el webhook y el disparador están funcionando correctamente, edite el disparador para eliminar la acción Notificar por > Destino y luego desactive o borre el destino.

Tecnología de Zendesk