zendesk-mobile-sdk-ios-integration

{
  "title": "Integração do SDK móvel do Zendesk para iOS: Um guia completo para 2026",
  "slug": "zendesk-mobile-sdk-ios-integration",
  "locale": "pt",
  "date": "2026-02-26",
  "updated": "2026-02-26",
  "template": "default",
  "excerpt": "Um guia prático para desenvolvedores sobre a integração do SDK do Zendesk para iOS, abordando métodos de instalação, inicialização, autenticação e personalização da interface do usuário.",
  "categories": [
    "Zendesk",
    "Guides"
  ],
  "tags": [
    "Zendesk",
    "iOS SDK",
    "Mobile Integration",
    "Customer Support",
    "App Development"
  ],
  "readTime": 9,
  "author": 16,
  "reviewer": 14,
  "seo": {
    "title": "Integração do SDK móvel do Zendesk para iOS: Um guia completo para 2026",
    "description": "Um guia prático para desenvolvedores sobre a integração do SDK do Zendesk para iOS, abordando métodos de instalação, inicialização, autenticação e personalização da interface do usuário.",
    "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": "Imagem do banner para a integração do SDK móvel do Zendesk para iOS: Um guia completo para 2026",
  "coverImageWidth": 1920,
  "coverImageHeight": 1080,
  "faqs": {
    "heading": "Perguntas Frequentes",
    "type": "blog",
    "answerType": "html",
    "faqs": [
      {
        "question": "Qual é a versão mínima do iOS necessária para a integração do SDK móvel do Zendesk?",
        "answer": "O SDK de Mensagens do Zendesk requer iOS 14 ou posterior a partir da versão 2.33.0. O SDK de Suporte clássico suportava iOS 12+, mas esse SDK agora está arquivado e não é mais mantido."
      },
      {
        "question": "Posso usar a integração do SDK móvel do Zendesk para iOS com projetos Swift e Objective-C?",
        "answer": "Sim, o SDK suporta Swift e Objective-C. Todos os exemplos de código na documentação são fornecidos em ambos os idiomas, e o SDK é construído com a interoperabilidade em mente."
      },
      {
        "question": "Como faço para lidar com notificações push com a integração do SDK móvel do Zendesk para iOS?",
        "answer": "As notificações push exigem a criação de um certificado SSL do serviço de notificação push da Apple, o upload do arquivo .p12 para o Centro de Administração do Zendesk, a adição do recurso de notificações push no Xcode e a implementação dos métodos UNUserNotificationCenterDelegate em seu AppDelegate. O SDK fornece métodos auxiliares para verificar se uma notificação push pertence ao Zendesk e deve ser exibida."
      },
      {
        "question": "A integração do SDK móvel do Zendesk para iOS é gratuita?",
        "answer": "O SDK em si é gratuito, mas você precisa de um plano Zendesk Support ou Suite para usá-lo. Os preços do Zendesk começam em US$ 19 por agente por mês para o plano Support Team. Os recursos do SDK disponíveis dependem do nível do seu plano Zendesk."
      },
      {
        "question": "Posso personalizar a aparência da integração do SDK móvel do Zendesk para iOS para corresponder ao meu aplicativo?",
        "answer": "Sim, você pode personalizar as cores do tema, o estilo da barra de navegação e alguns elementos da interface do usuário. No entanto, existem limitações conhecidas no iOS: você não pode alterar o avatar do Answer Bot, substituir o botão de navegação direito ou personalizar a fonte do texto do chat. A maior parte da marca é tratada por meio do Centro de Administração do Zendesk."
      },
      {
        "question": "Qual é a diferença entre autenticação anônima e JWT na integração do SDK móvel do Zendesk para iOS?",
        "answer": "A autenticação anônima cria um novo registro de usuário para cada dispositivo e é adequada para usuários de aplicativos não autenticados. A autenticação JWT verifica a identidade do usuário usando um token assinado e permite que os usuários acessem seu histórico de conversas em vários dispositivos. O JWT é recomendado para usuários conectados."
      }
    ],
    "supportLink": null
  }
}
---

Quando seus clientes precisam de ajuda, a última coisa que eles querem é sair do seu aplicativo. Fazer com que abram um navegador, procurem sua página de suporte ou vasculhem e-mails em busca de atualizações de tickets cria atrito que prejudica a experiência do cliente. É por isso que incorporar o suporte diretamente em seu aplicativo iOS com o [SDK móvel do Zendesk](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/getting_started/) se tornou essencial para o atendimento ao cliente moderno.

Este guia orienta você na integração do SDK do Zendesk para iOS do início ao fim. Esteja você criando um novo aplicativo ou adicionando suporte a um existente, você aprenderá as etapas exatas para fazer com que as mensagens do cliente funcionem em seu aplicativo. Para equipes que desejam adicionar respostas com tecnologia de IA ao seu suporte móvel, também abordaremos como o [eesel AI](https://www.eesel.ai/integration/zendesk-ai) funciona em conjunto com o SDK móvel do Zendesk.

![Página de destino do desenvolvedor Zendesk para documentação do SDK para iOS](https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/screenshots/zendesk-landing-page.png)

## O que você vai precisar

Antes de começar, aqui está o que você vai precisar:

- Um [plano Zendesk Support ou Suite](https://www.zendesk.com/pricing/)
- Xcode 11.4 ou posterior
- Um aplicativo iOS com como alvo iOS 14 ou posterior
- Acesso de administrador à sua conta Zendesk para recuperar as chaves do canal
- Projeto Swift 5.2.2+ ou Objective-C

O SDK suporta Swift e Objective-C, então você pode integrá-lo independentemente de qual linguagem seu aplicativo usa. O Swift Package Manager funciona melhor para projetos modernos, mas o CocoaPods e o Carthage permanecem disponíveis se seu projeto já depender deles.

## Passo 1: Escolha o SDK do Zendesk certo para suas necessidades

Muitos desenvolvedores não percebem que o Zendesk oferece vários SDKs para iOS. Escolher o errado pode criar problemas mais tarde, então vale a pena entender as diferenças antecipadamente.

### SDK de Mensagens do Zendesk (recomendado para novos projetos)

Este é o SDK moderno do Zendesk e aquele que você deve usar para qualquer nova integração. Ele fornece uma experiência de mensagens contemporânea onde os usuários podem ter conversas contínuas que persistem ao longo do tempo. O SDK de Mensagens é ativamente mantido, com a [versão mais recente (2.37.0)](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/release_notes/) lançada em janeiro de 2026.

As principais capacidades incluem:

- Suporte a múltiplas conversas (os usuários podem ter múltiplas conversas em andamento)
- Mensagens ricas com carrosséis, formulários e anexos de arquivos
- Suporte a notificações push para atualizações em tempo real
- Mensagens proativas de sua empresa
- Banners de tempo de espera mostrando a posição na fila

### SDK de Suporte Clássico (legado/arquivado)

**Importante:** O [SDK do Zendesk clássico para iOS](https://github.com/zendesk/zendesk_sdk_ios) foi arquivado em 23 de novembro de 2024. O repositório GitHub agora é somente leitura. Se você estiver usando este SDK atualmente, você deve planejar uma migração para o SDK de Mensagens. Consulte o [guia de migração](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/chat_migration/) do Zendesk para obter etapas detalhadas.

### SDK de Conversas Sunshine (casos de uso avançados)

Para aplicativos que precisam de experiências de mensagens altamente personalizadas, o [Sunshine Conversations](https://docs.smooch.io/guide/native-ios-sdk/) (anteriormente Smooch) oferece mais flexibilidade. Ele suporta recursos avançados como implementações de UI personalizadas e fluxos de trabalho conversacionais complexos. No entanto, para a maioria dos casos de uso de suporte padrão, o SDK de Mensagens é a melhor escolha.

## Passo 2: Adicione o SDK ao seu projeto Xcode

O [SDK de Mensagens do Zendesk](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/getting_started/) suporta quatro métodos de instalação. O Swift Package Manager é a abordagem recomendada para o desenvolvimento iOS moderno.

### Swift Package Manager (recomendado)

1. No Xcode, selecione **File > Swift Packages > Add Package Dependency**
2. Insira o URL do repositório: `https://github.com/zendesk/sdk_messaging_ios/`
3. Siga as instruções do Xcode para adicionar ZendeskMessagingSDK como uma dependência

O Xcode irá resolver e baixar automaticamente todas as dependências necessárias.

### CocoaPods

Adicione esta linha ao seu Podfile:

pod 'ZendeskSDKMessaging'

Então execute `pod install`.

### Carthage

Adicione isto ao seu Cartfile:

github "zendesk/sdk_messaging_ios"

Execute `carthage update --use-xcframeworks`, então arraste os frameworks para o seu projeto.

### Permissões necessárias

Adicione estas chaves ao Info.plist do seu aplicativo para habilitar o acesso à câmera, microfone e biblioteca de fotos:

- `NSCameraUsageDescription` permite o acesso à câmera para imagens e vídeos
- `NSMicrophoneUsageDescription` permite o acesso ao microfone para captura de vídeo
- `NSPhotoLibraryUsageDescription` permite o acesso de leitura/gravação à biblioteca de fotos

![Navegador de projeto Xcode mostrando a estrutura de arquivos do projeto iOS](https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ios_select_project.png)

## Passo 3: Inicialize o SDK em seu aplicativo

Uma vez que o SDK é adicionado ao seu projeto, você precisa inicializá-lo com sua chave de canal.

### Obtendo sua chave de canal

Sua chave de canal é gerada no Centro de Administração do Zendesk:

1. Faça login no [Centro de Administração do Zendesk](https://support.zendesk.com/hc/en-us/articles/4581766374554-Using-Zendesk-Admin-Center)
2. Navegue para Canais > Mensagens
3. Clique em **Adicionar Canal** e selecione iOS
4. Siga as instruções para gerar sua chave de canal

![Aba de instalação do Centro de Administração do Zendesk com o ID do Canal destacado](https://zen-marketing-documentation.s3.amazonaws.com/docs/en/mobile_sdk_installation_tab.png)

### Código de inicialização

Adicione estas importações ao seu AppDelegate ou arquivo principal do aplicativo:

**Swift:**
```swift
import ZendeskSDKMessaging
import ZendeskSDK

Objective-C:

#import <ZendeskSDKMessaging/ZendeskSDKMessaging.h>
#import <ZendeskSDK/ZendeskSDK.h>

Inicialize o SDK na inicialização do aplicativo:

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);
    }
}];

O tamanho do SDK é de aproximadamente 7,5 MB para o download do XCFramework, embora o impacto final no tamanho do seu aplicativo possa ser menor devido ao app thinning e às otimizações do linker.

Passo 4: Configure a autenticação do usuário

O SDK suporta dois métodos de autenticação dependendo do seu caso de uso.

Autenticação anônima

Para usuários que não fizeram login em seu aplicativo, use a autenticação anônima:

Swift:

let identity = Identity.createAnonymous()
Zendesk.instance?.setIdentity(identity)

Isso cria um novo registro de usuário no Zendesk para cada dispositivo.

Autenticação JWT

Para usuários autenticados, use JWT para verificar sua identidade:

Swift:

let identity = Identity.createJwt(token: "<your_jwt_token>")
Zendesk.instance?.setIdentity(identity)

A autenticação JWT garante que os usuários possam acessar seu histórico de conversas em vários dispositivos e evita a falsificação. A partir da versão 2.34.0 do SDK, também existe um AuthenticationDelegate para lidar com a atualização do token de forma integrada.

Passo 5: Exiba a interface de mensagens

Uma vez inicializado, você pode apresentar a interface de mensagens em qualquer lugar do seu aplicativo.

Apresentação 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];
}

Apresentação modal

Para uma experiência modal em vez de empurrar para a pilha de navegação:

Swift:

if let viewController = Zendesk.instance?.messaging?.messagingViewController() {
    let navigationController = UINavigationController(rootViewController: viewController)
    navigationController.modalPresentationStyle = .fullScreen
    present(navigationController, animated: true)
}

Por padrão, o SDK navega para a conversa ativa mais recente. Se sua conta tiver várias conversas habilitadas, os usuários poderão gerenciar várias conversas em andamento ao mesmo tempo.

Passo 6: Personalize a UI e o comportamento

O SDK oferece várias opções de personalização para corresponder à marca do seu aplicativo.

Cores do tema

Você pode personalizar as cores através do Centro de Administração do Zendesk, ou programaticamente para mais controle. Defina sua cor primária usando:

CommonTheme.currentTheme.primaryColor = .cyan

Personalização da barra de navegação

Para o estilo da barra de navegação, use o proxy UIAppearance padrão:

UINavigationBar.appearance().barTintColor = .cyan

Formulários de pré-chat e configuração de bot

Você pode configurar formulários de pré-chat para coletar informações do usuário antes de iniciar uma conversa. Configure os formulários através do seu Centro de Administração do Zendesk, ou use as opções de configuração do SDK para personalizar a experiência.

Limitações conhecidas do iOS

Esteja ciente destas limitações de personalização no iOS:

• O avatar do Answer Bot não pode ser alterado
• O botão da barra de navegação direita não pode ser substituído
• A cor do título da navegação tem opções de personalização limitadas
• A fonte do texto do chat não pode ser alterada

Essas limitações estão documentadas na documentação do iOS do Zendesk e são consistentes em todas as implementações do iOS.

Problemas comuns e solução de problemas

Aqui estão as soluções para problemas que os desenvolvedores encontram frequentemente:

Falhas de inicialização

Se o SDK não conseguir inicializar:

• Verifique se sua chave de canal está correta e corresponde ao ID do pacote do seu aplicativo
• Certifique-se de que sua conta Zendesk tenha mensagens habilitadas
• Verifique se você está usando o endpoint de região correto (EUA ou UE)

Problemas de notificação push

As notificações push precisam de uma configuração cuidadosa:

1. Certifique-se de que você carregou seu certificado .p12 para o Centro de Administração do Zendesk
2. Verifique se o direito do Ambiente APS está definido como "produção" (não desenvolvimento)
3. Verifique se o seu perfil de provisionamento inclui recursos de notificação push
4. Certifique-se de que você está usando um certificado combinado Sandbox & Produção, não apenas Sandbox

Fonte: Guia de configuração de notificação push do Zendesk

Erros de autenticação

Problemas de autenticação JWT geralmente decorrem de:

• Tokens expirados implemente a atualização do token usando AuthenticationDelegate
• Formato de token incorreto certifique-se de que seu JWT segue as reivindicações necessárias do Zendesk
• Desvio de relógio verifique se os horários do servidor e do dispositivo estão sincronizados

Memória e desempenho

O SDK é leve, mas você deve:

• Inicializá-lo uma vez na inicialização do aplicativo, não repetidamente
• Lidar com avisos de memória apropriadamente
• Testar em dispositivos mais antigos se seu aplicativo suportar iOS 14

Melhorando o suporte móvel com eesel AI

Embora o SDK móvel do Zendesk forneça a base para o atendimento ao cliente no aplicativo, muitas equipes desejam adicionar automação inteligente para lidar com perguntas comuns sem intervenção humana. É aí que entramos.

Na eesel AI, construímos uma plataforma de IA que funciona em conjunto com sua configuração do Zendesk para automatizar respostas e melhorar as taxas de desvio. Em vez de apenas rotear tickets, nossa IA pode resolver problemas comuns extraindo de toda a sua base de conhecimento, não apenas de artigos do Zendesk Guide.

Veja como as equipes normalmente nos usam em conjunto com sua integração do SDK móvel do Zendesk:

• Conecte múltiplas fontes de conhecimento Nós extraímos respostas de Confluence, Google Docs, Notion e outras plataformas onde sua documentação reside, para que os clientes obtenham respostas completas, mesmo quando as informações estão espalhadas

• Teste antes de entrar em produção Nosso modo de simulação permite que você teste as respostas da IA em relação aos seus tickets anteriores para prever as taxas de desvio antes que os clientes as vejam

• Implantação progressiva Comece com a IA redigindo respostas para revisão, depois expanda para automação total à medida que a confiança aumenta

Se você já está planejando uma integração do SDK móvel do Zendesk, adicionar respostas com tecnologia de IA pode reduzir o volume de tickets que chegam aos seus agentes humanos. Confira nossa integração do Zendesk para ver como funciona.

Comece a construir um suporte móvel melhor hoje

Integrar o SDK móvel do Zendesk em seu aplicativo iOS é simples, uma vez que você conhece as etapas. A chave é escolher o SDK certo (SDK de Mensagens para novos projetos), obter sua chave de canal do Centro de Administração e lidar com a autenticação apropriadamente para seu caso de uso.

O SDK oferece uma experiência de suporte profissional com o mínimo de esforço de desenvolvimento. E se você quiser ir mais longe com a automação com tecnologia de IA, o eesel AI pode ajudá-lo a desviar mais tickets e resolver problemas mais rapidamente.

Pronto para começar? Vá para a documentação do desenvolvedor Zendesk para obter a versão mais recente do SDK e referências detalhadas da API.