Ir al contenido principal

Guía de integración: Zendesk

Esta guía cubre la configuración, las opciones de envíos, los mensajes entrantes y la solución de problemas.

Actualizado hoy

Instalación y configuración

Instala la app

  1. Ve a la app SMS de ClickSend en el Zendesk Marketplace.

  2. Haz clic en Instalar y escoge tu cuenta de Zendesk.

  3. Haz clic en Instalar de nuevo para confirmar.

Autentícate con ClickSend

  1. En Zendesk, ve al Centro de administración > Aplicaciones e integraciones > ClickSend SMS.

  2. Introduce tu nombre de usuario de ClickSend y clave de API (se encuentra aquí).

  3. Haz clic en Conectar a ClickSend.

  4. Una vez conectado, tu historial de SMS se rellenará.


Envíos de SMS desde Zendesk

Hay tres formas de enviar SMS dentro de Zendesk:

1. Barra superior (SMS rápido – Recomendado)

  • Accesible desde cualquier página en Zendesk.

  • Ideal para mensajes rápidos y personalizados a contactos.

2. Barra lateral de la incidencia

  • Úsala al trabajar en una incidencia con un número de teléfono guardado.

  • Ideal para respuestas de atención al cliente dentro de las conversaciones.

3. Barra de navegación (mensajería masiva)

  • Enviar SMS individuales o envíos masivos de SMS a grupos u organizaciones.

  • Genial para anuncios, promociones o alertas.


Recepción de SMS entrantes

  • Las respuestas aparecen en tiempo real en tu panel de control de Zendesk.

  • Los mensajes no leídos muestran un indicador de punto rojo.

  • Nota: Puede que Zendesk no muestre respuestas si tu cuenta de ClickSend tiene más de 10 reglas entrantes. Más información sobre las reglas entrantes.

Consejo: Revisa regularmente tu panel de control para asegurar respuestas oportunas.


SMS automatizados mediante webhooks y disparadores

Usa los disparadores de Zendesk para enviar SMS automáticamente cuando se produzcan actualizaciones de incidencias.

Crear un webhook

  1. Ve al Centro de administración > Aplicaciones e integraciones > Webhooks.

  2. Haz clic en Crear webhook.

  3. Usa los siguientes ajustes:

    1. URL del punto de conexión: https://rest.clicksend.com/v3/sms/send

    2. Método: POST

    3. Formato: JSON

    4. Autenticación: Autenticación básica (nombre de usuario de ClickSend + clave de API)

Añadir un disparador

  1. Ve a Disparadores > Añadir disparador.

  2. Escoge una categoría (por ejemplo, Incidencias).

  3. Añade una acción:

    • Notificar webhook activo → selecciona tu webhook de ClickSend.

  4. Añade esto al cuerpo del JSON:

Básico:

{
"messages": [
{
"to": "+61411111111",
"source": "zendesk",
"body": "this is a test message"
}
]
}

Ejemplo dinámico:

{
"messages": [
{
"to": "##{{current_user.phone}}",
"source": "zendesk",
"body": "Hi ##{{current_user.first_name}}, the ##{{ticket.brand.name}} status has been changed to ##{{ticket.status}}."
}
]
}


Preguntas frecuentes

¿Cómo me autentico?

Usa tu nombre de usuario de ClickSend y clave de API (no tu contraseña).

¿Puedo seguir la entrega de SMS?

Sí, el estado de SMS se puede seguir mediante la Barra superior, la Barra lateral y la Barra de navegación.

¿Puedo enviar mensajes masivos?

Sí, usa la Barra de navegación y selecciona un grupo u organización.

¿Funcionan las respuestas con todos los tipos de remitente?

Las respuestas funcionan con números compartidos o dedicados. No es compatible con etiquetas alfa ni con tu propio número.

¿Puedo usar un ID de remitente de etiqueta alfa?

Sí, en los países admitidos. Límite: 11 caracteres, sin espacios.

Añade el campo from en el cuerpo del JSON:

{
"messages": [
{
"to": "+61411111111",
"from": "MyCompany",
"body": "this is a test message"
}
]
}


Solución de problemas

  • Autenticación

    • Asegúrate de que estás usando tu nombre de usuario de ClickSend y clave de API, no tu contraseña.

  • ¿Los SMS entrantes no funcionan?

    • Asegúrate de tener un número dedicado.

    • Limita las reglas de webhooks a menos de 10.

  • Crédito de la cuenta

    • Asegúrate de que tu cuenta de ClickSend tenga suficiente crédito. Recarga aquí.

  • Envíos globales

    • Activa los envíos globales para tus países objetivo. Contacta con el servicio de asistencia para obtener ayuda.

  • Formato de número de teléfono

    • Usa el formato internacional (por ejemplo, +1XXXXXXXXXX para EE. UU.).

  • Campos de mensaje faltantes

    • Asegúrate de que los campos obligatorios como el número del destinatario y el cuerpo del mensaje estén rellenados.

¿Ha quedado contestada tu pregunta?