zendesk-mobile-sdk-ios-integration
eesel Team
Last edited 26 febrero 2026
{
"title": "Integración del SDK móvil de Zendesk para iOS: Una guía completa para 2026",
"slug": "zendesk-mobile-sdk-ios-integration",
"locale": "es",
"date": "2026-02-26",
"updated": "2026-02-26",
"template": "default",
"excerpt": "Una guía práctica para desarrolladores sobre la integración del SDK de iOS de Zendesk, que abarca los métodos de instalación, la inicialización, la autenticación y la personalización de la interfaz de usuario.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk",
"iOS SDK",
"Mobile Integration",
"Customer Support",
"App Development"
],
"readTime": 9,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Integración del SDK móvil de Zendesk para iOS: Una guía completa para 2026",
"description": "Una guía práctica para desarrolladores sobre la integración del SDK de iOS de Zendesk, que abarca los métodos de instalación, la inicialización, la autenticación y la personalización de la interfaz de usuario.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-423d5b0b-218b-41f8-bbbc-b17d7d8c284d"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-423d5b0b-218b-41f8-bbbc-b17d7d8c284d",
"coverImageAlt": "Imagen del banner para la integración del SDK móvil de Zendesk para iOS: Una guía completa para 2026",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Preguntas frecuentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "¿Cuál es la versión mínima de iOS requerida para la integración del SDK móvil de Zendesk?",
"answer": "El SDK de mensajería de Zendesk requiere iOS 14 o posterior a partir de la versión 2.33.0. El SDK de soporte clásico admitía iOS 12+, pero ese SDK ahora está archivado y ya no se mantiene."
},
{
"question": "¿Puedo usar la integración del SDK móvil de Zendesk para iOS con proyectos Swift y Objective-C?",
"answer": "Sí, el SDK es compatible con Swift y Objective-C. Todos los ejemplos de código en la documentación se proporcionan en ambos idiomas, y el SDK está construido teniendo en cuenta la interoperabilidad."
},
{
"question": "¿Cómo manejo las notificaciones push con la integración del SDK móvil de Zendesk para iOS?",
"answer": "Las notificaciones push requieren la creación de un certificado SSL del servicio de notificaciones push de Apple, la carga del archivo .p12 al Centro de administración de Zendesk, la adición de la capacidad de notificaciones push en Xcode y la implementación de los métodos UNUserNotificationCenterDelegate en su AppDelegate. El SDK proporciona métodos auxiliares para verificar si una notificación push pertenece a Zendesk y debe mostrarse."
},
{
"question": "¿Es gratis la integración del SDK móvil de Zendesk para iOS?",
"answer": "El SDK en sí es gratuito, pero necesita un plan de Soporte o Suite de Zendesk para usarlo. Los precios de Zendesk comienzan en $19 por agente por mes para el plan de Equipo de Soporte. Las características del SDK disponibles dependen de su nivel de plan de Zendesk."
},
{
"question": "¿Puedo personalizar la apariencia de la integración del SDK móvil de Zendesk para iOS para que coincida con mi aplicación?",
"answer": "Sí, puede personalizar los colores del tema, el estilo de la barra de navegación y algunos elementos de la interfaz de usuario. Sin embargo, existen limitaciones conocidas en iOS: no puede cambiar el avatar de Answer Bot, anular el botón de navegación derecho o personalizar la fuente del texto del chat. La mayoría de la marca se gestiona a través del Centro de administración de Zendesk."
},
{
"question": "¿Cuál es la diferencia entre la autenticación anónima y la autenticación JWT en la integración del SDK móvil de Zendesk para iOS?",
"answer": "La autenticación anónima crea un nuevo registro de usuario para cada dispositivo y es adecuada para usuarios de aplicaciones no autenticados. La autenticación JWT verifica la identidad del usuario mediante un token firmado y permite a los usuarios acceder a su historial de conversaciones en varios dispositivos. Se recomienda JWT para usuarios que han iniciado sesión."
}
],
"supportLink": null
}
}
---
Cuando sus clientes necesitan ayuda, lo último que quieren es salir de su aplicación. Hacer que abran un navegador, busquen su página de soporte o busquen actualizaciones de tickets en el correo electrónico crea fricción que perjudica la experiencia del cliente. Es por eso que integrar el soporte directamente en su aplicación iOS con el [SDK móvil de Zendesk](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/getting_started/) se ha vuelto esencial para el servicio al cliente moderno.
Esta guía lo guía a través de la integración del SDK de iOS de Zendesk de principio a fin. Ya sea que esté construyendo una nueva aplicación o agregando soporte a una existente, aprenderá los pasos exactos para que la mensajería del cliente funcione en su aplicación. Para los equipos que buscan agregar respuestas impulsadas por IA a su soporte móvil, también cubriremos cómo [eesel AI](https://www.eesel.ai/integration/zendesk-ai) funciona junto con el SDK móvil de Zendesk.
## Lo que necesitará
Antes de comenzar, esto es lo que necesitará:
- Un [plan de Soporte o Suite de Zendesk](https://www.zendesk.com/pricing/)
- Xcode 11.4 o posterior
- Una aplicación iOS dirigida a iOS 14 o posterior
- Acceso de administrador a su cuenta de Zendesk para recuperar las claves del canal
- Proyecto Swift 5.2.2+ u Objective-C
El SDK es compatible con Swift y Objective-C, por lo que puede integrarlo independientemente del idioma que use su aplicación. Swift Package Manager funciona mejor para proyectos modernos, pero CocoaPods y Carthage siguen estando disponibles si su proyecto ya depende de ellos.
## Paso 1: Elija el SDK de Zendesk adecuado para sus necesidades
Muchos desarrolladores no se dan cuenta de que Zendesk ofrece múltiples SDK para iOS. Elegir el incorrecto puede crear problemas más adelante, por lo que vale la pena comprender las diferencias por adelantado.
### SDK de mensajería de Zendesk (recomendado para nuevos proyectos)
Este es el SDK moderno de Zendesk y el que debe usar para cualquier nueva integración. Proporciona una experiencia de mensajería contemporánea donde los usuarios pueden tener conversaciones continuas que persisten en el tiempo. El SDK de mensajería se mantiene activamente, con la [última versión (2.37.0)](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/release_notes/) lanzada en enero de 2026.
Las capacidades clave incluyen:
- Soporte para múltiples conversaciones (los usuarios pueden tener múltiples conversaciones en curso)
- Mensajería enriquecida con carruseles, formularios y archivos adjuntos
- Soporte de notificaciones push para actualizaciones en tiempo real
- Mensajería proactiva de su empresa
- Banners de tiempo de espera que muestran la posición en la cola
### SDK de soporte clásico (legado/archivado)
**Importante:** El [SDK de Zendesk clásico para iOS](https://github.com/zendesk/zendesk_sdk_ios) fue archivado el 23 de noviembre de 2024. El repositorio de GitHub ahora es de solo lectura. Si actualmente está utilizando este SDK, debe planificar una migración al SDK de mensajería. Consulte la [guía de migración](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/chat_migration/) de Zendesk para obtener pasos detallados.
### SDK de Sunshine Conversations (casos de uso avanzados)
Para las aplicaciones que necesitan experiencias de mensajería altamente personalizadas, [Sunshine Conversations](https://docs.smooch.io/guide/native-ios-sdk/) (anteriormente Smooch) ofrece más flexibilidad. Admite funciones avanzadas como implementaciones de interfaz de usuario personalizadas y flujos de trabajo conversacionales complejos. Sin embargo, para la mayoría de los casos de uso de soporte estándar, el SDK de mensajería es la mejor opción.
## Paso 2: Agregue el SDK a su proyecto Xcode
El [SDK de mensajería de Zendesk](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/getting_started/) admite cuatro métodos de instalación. Swift Package Manager es el enfoque recomendado para el desarrollo moderno de iOS.
### Swift Package Manager (recomendado)
1. En Xcode, seleccione **File > Swift Packages > Add Package Dependency**
2. Ingrese la URL del repositorio: `https://github.com/zendesk/sdk_messaging_ios/`
3. Siga las indicaciones de Xcode para agregar ZendeskMessagingSDK como una dependencia
Xcode resolverá y descargará automáticamente todas las dependencias necesarias.
### CocoaPods
Agregue esta línea a su Podfile:
pod 'ZendeskSDKMessaging'
Luego ejecute `pod install`.
### Carthage
Agregue esto a su Cartfile:
github "zendesk/sdk_messaging_ios"
Ejecute `carthage update --use-xcframeworks`, luego arrastre los frameworks a su proyecto.
### Permisos requeridos
Agregue estas claves al Info.plist de su aplicación para habilitar el acceso a la cámara, el micrófono y la biblioteca de fotos:
- `NSCameraUsageDescription` permite el acceso a la cámara para imágenes y videos
- `NSMicrophoneUsageDescription` permite el acceso al micrófono para la captura de video
- `NSPhotoLibraryUsageDescription` permite el acceso de lectura/escritura a la biblioteca de fotos
## Paso 3: Inicialice el SDK en su aplicación
Una vez que el SDK se agrega a su proyecto, debe inicializarlo con la clave de su canal.
### Obtención de la clave de su canal
Su clave de canal se genera en el Centro de administración de Zendesk:
1. Inicie sesión en el [Centro de administración de Zendesk](https://support.zendesk.com/hc/en-us/articles/4581766374554-Using-Zendesk-Admin-Center)
2. Navegue a Canales > Mensajería
3. Haga clic en **Agregar canal** y seleccione iOS
4. Siga las indicaciones para generar la clave de su canal
### Código de inicialización
Agregue estas importaciones a su AppDelegate o archivo de aplicación principal:
**Swift:**
```swift
import ZendeskSDKMessaging
import ZendeskSDK
Objective-C:
#import <ZendeskSDKMessaging/ZendeskSDKMessaging.h>
#import <ZendeskSDK/ZendeskSDK.h>
Inicialice el SDK al iniciar la aplicación:
Swift:
Zendesk.initialize(
withChannelKey: "<your_channel_key>",
messagingFactory: DefaultMessagingFactory()
) { result in
if case let .failure(error) = result {
print("Messaging did not initialize. Error: \(error.localizedDescription)")
}
}
Objective-C:
[Zendesk initializeWithChannelKey:@"<your_channel_key>"
messagingFactory:[[ZDKDefaultMessagingFactory alloc] init]
completionHandler:^(Zendesk * _Nullable zendesk, NSError * _Nullable error) {
if (error != nil) {
NSLog(@"Zendesk did not initialize. Error: %@", error.localizedDescription);
}
}];
El tamaño del SDK es de aproximadamente 7.5 MB para la descarga de XCFramework, aunque el impacto final en el tamaño de su aplicación puede ser menor debido al adelgazamiento de la aplicación y las optimizaciones del enlazador.
Paso 4: Configure la autenticación del usuario
El SDK admite dos métodos de autenticación según su caso de uso.
Autenticación anónima
Para los usuarios que no han iniciado sesión en su aplicación, use la autenticación anónima:
Swift:
let identity = Identity.createAnonymous()
Zendesk.instance?.setIdentity(identity)
Esto crea un nuevo registro de usuario en Zendesk para cada dispositivo.
Autenticación JWT
Para los usuarios autenticados, use JWT para verificar su identidad:
Swift:
let identity = Identity.createJwt(token: "<your_jwt_token>")
Zendesk.instance?.setIdentity(identity)
La autenticación JWT garantiza que los usuarios puedan acceder a su historial de conversaciones en varios dispositivos y evita la suplantación de identidad. A partir de la versión 2.34.0 del SDK, también hay un AuthenticationDelegate para manejar la actualización del token sin problemas.
Paso 5: Muestre la interfaz de mensajería
Una vez inicializado, puede presentar la interfaz de mensajería en cualquier lugar de su aplicación.
Presentación básica
Swift:
if let viewController = Zendesk.instance?.messaging?.messagingViewController() {
self.navigationController?.show(viewController, sender: self)
}
Objective-C:
UIViewController *viewController = [Zendesk.instance.messaging messagingViewController];
if (viewController != NULL) {
[self.navigationController showViewController:viewController sender:self];
}
Presentación modal
Para una experiencia modal en lugar de insertar en la pila de navegación:
Swift:
if let viewController = Zendesk.instance?.messaging?.messagingViewController() {
let navigationController = UINavigationController(rootViewController: viewController)
navigationController.modalPresentationStyle = .fullScreen
present(navigationController, animated: true)
}
De forma predeterminada, el SDK navega a la conversación activa más reciente. Si su cuenta tiene habilitadas varias conversaciones, los usuarios pueden administrar varias conversaciones en curso a la vez.
Paso 6: Personalice la interfaz de usuario y el comportamiento
El SDK ofrece varias opciones de personalización para que coincida con la marca de su aplicación.
Colores del tema
Puede personalizar los colores a través del Centro de administración de Zendesk o mediante programación para tener más control. Establezca su color primario usando:
CommonTheme.currentTheme.primaryColor = .cyan
Personalización de la barra de navegación
Para el estilo de la barra de navegación, use el proxy UIAppearance estándar:
UINavigationBar.appearance().barTintColor = .cyan
Formularios previos al chat y configuración del bot
Puede configurar formularios previos al chat para recopilar información del usuario antes de iniciar una conversación. Configure los formularios a través de su Centro de administración de Zendesk o use las opciones de configuración del SDK para personalizar la experiencia.
Limitaciones conocidas de iOS
Tenga en cuenta estas limitaciones de personalización en iOS:
- El avatar de Answer Bot no se puede cambiar
- El botón de la barra de navegación derecha no se puede anular
- El color del título de la navegación tiene opciones de personalización limitadas
- La fuente del texto del chat no se puede cambiar
Estas limitaciones están documentadas en la documentación de iOS de Zendesk y son consistentes en todas las implementaciones de iOS.
Problemas comunes y solución de problemas
Aquí hay soluciones a los problemas que los desarrolladores encuentran con frecuencia:
Fallas de inicialización
Si el SDK no se inicializa:
- Verifique que la clave de su canal sea correcta y coincida con el ID del paquete de su aplicación
- Asegúrese de que su cuenta de Zendesk tenga la mensajería habilitada
- Verifique que esté utilizando el punto final de región correcto (EE. UU. o UE)
Problemas con las notificaciones push
Las notificaciones push necesitan una configuración cuidadosa:
- Asegúrese de haber cargado su certificado .p12 al Centro de administración de Zendesk
- Verifique que el derecho del entorno APS esté configurado en "producción" (no en desarrollo)
- Verifique que su perfil de aprovisionamiento incluya capacidades de notificación push
- Asegúrese de estar utilizando un certificado combinado de Sandbox y Producción, no solo de Sandbox
Fuente: Guía de configuración de notificaciones push de Zendesk
Errores de autenticación
Los problemas de autenticación JWT generalmente provienen de:
- Tokens caducados implemente la actualización del token usando AuthenticationDelegate
- Formato de token incorrecto asegúrese de que su JWT siga las reclamaciones requeridas de Zendesk
- Desfase del reloj verifique que la hora del servidor y del dispositivo estén sincronizadas
Memoria y rendimiento
El SDK es liviano, pero debe:
- Inicializarlo una vez al iniciar la aplicación, no repetidamente
- Manejar las advertencias de memoria apropiadamente
- Pruebe en dispositivos más antiguos si su aplicación es compatible con iOS 14
Mejora del soporte móvil con eesel AI
Si bien el SDK móvil de Zendesk proporciona la base para el servicio al cliente en la aplicación, muchos equipos desean agregar automatización inteligente para manejar las preguntas comunes sin intervención humana. Ahí es donde entramos nosotros.
En eesel AI, hemos creado una plataforma de IA que funciona junto con su configuración de Zendesk para automatizar las respuestas y mejorar las tasas de desvío. En lugar de simplemente enrutar los tickets, nuestra IA puede resolver problemas comunes extrayendo de toda su base de conocimientos, no solo de los artículos de la Guía de Zendesk.
Así es como los equipos suelen utilizarnos junto con su integración del SDK móvil de Zendesk:
-
Conecte múltiples fuentes de conocimiento Extraemos respuestas de Confluence, Google Docs, Notion y otras plataformas donde vive su documentación, para que los clientes obtengan respuestas completas incluso cuando la información está dispersa
-
Pruebe antes de poner en marcha Nuestro modo de simulación le permite probar las respuestas de la IA con sus tickets anteriores para pronosticar las tasas de desvío antes de que los clientes lo vean
-
Implementación progresiva Comience con la IA redactando respuestas para su revisión, luego expanda a la automatización completa a medida que aumenta la confianza
Si ya está planeando una integración del SDK móvil de Zendesk, agregar respuestas impulsadas por IA puede reducir el volumen de tickets que llegan a sus agentes humanos. Consulte nuestra integración de Zendesk para ver cómo funciona.
Comience a construir un mejor soporte móvil hoy
Integrar el SDK móvil de Zendesk en su aplicación iOS es sencillo una vez que conoce los pasos. La clave es elegir el SDK correcto (SDK de mensajería para nuevos proyectos), obtener la clave de su canal del Centro de administración y manejar la autenticación de manera apropiada para su caso de uso.
El SDK le brinda una experiencia de soporte profesional con un mínimo esfuerzo de desarrollo. Y si desea llevarlo más allá con la automatización impulsada por IA, eesel AI puede ayudarlo a desviar más tickets y resolver problemas más rápido.
¿Listo para comenzar? Diríjase a la documentación para desarrolladores de Zendesk para obtener la última versión del SDK y referencias detalladas de la API.
Compartir esta entrada
Article by
