Etapas de integração do Freshchat iOS SDK

//You can set custom user properties for a particular user
Freshchat.sharedInstance().setUserPropertyforKey("customerType", withValue: "Premium")
//You can set user demographic information
Freshchat.sharedInstance().setUserPropertyforKey("city", withValue: "San Bruno")
//You can segment based on where the user is in their journey of using your app
Freshchat.sharedInstance().setUserPropertyforKey("loggedIn", withValue: "true")
//You can capture a state of the user that includes what the user has done in your app
Freshchat.sharedInstance().setUserPropertyforKey("transactionCount", withValue: "3")

3.3 Registrar eventos do usuário na linha do tempo

O rastreamento de eventos do usuário fornecerá mais informações e contexto sobre o(s) usuário(s) em seu aplicativo. Eventos como ações do usuário e casos de falha/erro podem ser rastreados usando esta API. Os eventos rastreados são listados na Linha do tempo de eventos no lado do agente.

Objetivo C

[[Freshchat sharedInstance] trackEvent:"Event_Name" withProperties:PropertiesDictionary];

Rápido

Freshchat.sharedInstance()?.trackEvent("Event_Name", withProperties: PropertiesDictionary)

Observação: 
1. O Freshchat permite apenas 121 eventos únicos por conta. 
2. O nome do evento aceita valor de string (máximo de 32 caracteres). 
3. O nome da chave de propriedade deve ser do tipo string (máximo de 32 caracteres). 
4. O valor da propriedade pode ser de qualquer tipo de objeto primitivo (máximo de 256 caracteres). 
5. O Freshchat permite enviar no máximo 20 propriedades por evento.

3.4 Redefinir dados do usuário

Redefina os dados do usuário ao sair ou quando for considerado apropriado com base na ação do usuário no aplicativo invocando a API resetUser.

Objetivo C

[[Freshchat sharedInstance] resetUserWithCompletion:^
{        //Completion block code here
}];

Freshchat.sharedInstance().resetUser(completion: { () in            //Completion code
})

Observação: a ID externa não pode ser alterada depois de definida para um usuário.

ConversationOptions *options = [ConversationOptions new];
[options filterByTags:@[ @"all", @"paiduser" ]
withTitle:@"Filter_View_Title"];
[[Freshchat sharedInstance] showConversations:self withOptions: options];

Rápido

let options = ConversationOptions.init()
let tags: [String] = ["all","paidUser"]  //Your filter tags
options.filter(byTags: tags, withTitle: "Filter_View_Title")
Freshchat.sharedInstance().showConversations(self, with: options)

let options = FAQOptions.init()
let tags: [String] = ["payment","billing"]
options.filter(byTags: tags, withTitle:"Filtered_View_title", andType :ARTICLE)
Freshchat.sharedInstance().showFAQs(self, with: options)

Filtragem de perguntas frequentes com categoria

let options = FAQOptions.init()
let tags: [String] = ["payment", "billing"]
options.filter(byTags: tags, withTitle:"Filtered_View_Title", andType :CATEGORY)
Freshchat.sharedInstance().showFAQs(self, with: options)

Observação: quando você filtra um artigo por tags, as tags de categoria (à qual o artigo pertence) também são aplicáveis.

//@available(iOS 10.0, *)
func userNotificationCenter(_ center: UNUserNotificationCenter,        willPresent: UNNotification,        withCompletionHandler: @escaping (UNNotificationPresentationOptions)->()) {
if Freshchat.sharedInstance().isFreshchatNotification(willPresent.request.content.userInfo) {   Freshchat.sharedInstance().handleRemoteNotification(willPresent.reque
st.content.userInfo, andAppstate: UIApplication.shared.applicationState)  //Handled for freshchat notifications    withCompletionHandler([.sound])
} else {    withCompletionHandler([.alert, .sound, .badge]) //For other notifications         }
}
//@available(iOS 10.0, *)
func userNotificationCenter(_ center: UNUserNotificationCenter,                          didReceive: UNNotificationResponse,                          withCompletionHandler: @escaping ()->()) {
if Freshchat.sharedInstance().isFreshchatNotification(didReceive.notification.request.content.userInfo) {  Freshchat.sharedInstance().handleRemoteNotification(didReceive.notific
ation.request.content.userInfo, andAppstate: UIApplication.shared.applicationState) //Handled for freshchat notifications       withCompletionHandler()
} else {       withCompletionHandler() //For other notifications    }
}

7. Localização de idioma 

7.1 Suporte a idiomas da direita para a esquerda

O Freshchat SDK suporta idiomas RTL (árabe). 

Defina o valor 'NSTextAlignmentNatural' para UserMessageTextStyle/TeamMemberMessageTextStyle textAlignment para oferecer suporte a mensagens de conversa para idiomas RTL.

7.2 Mudança de localidade em tempo de execução 

Se seu aplicativo oferecer suporte à alteração de localidade de tempo de execução, adicione o nome de notificação local FRESHCHAT_USER_LOCALE_CHANGED ao seu método de alteração de localidade.

Objetivo C

[[NSNotificationCenter defaultCenter]
postNotificationName:FRESHCHAT_USER_LOCALE_CHANGED 
object:self];

NotificationCenter.default.post(name: NSNotification.Name(rawValue:
FRESHCHAT_USER_LOCALE_CHANGED), object: self, userInfo: nil)

Mudando as cordas  

1. Para alterar uma string específica usada na IU do SDK, basta atualizar a chave apropriada em FCLocalizable.strings. Os nomes-chave no arquivo são categorizados por interface do usuário e as chaves usadas são autoexplicativas.

2. Faça o mesmo para todos os idiomas que deseja oferecer suporte
3. O SDK vem apenas em inglês no momento, mas você poderá usar traduções para qualquer idioma que desejar. 

Vinculando ao projeto

1. Depois de alterar todas as strings necessárias nos idiomas que você oferece suporte, vincule-o em “Build Phases” > “Copy Bundle Resources”.

2. Ao inicializar o SDK, especifique o nome do pacote como parte da configuração do Freshchat. 
3. Defina seus recursos de pacote personalizados

Objetivo C

config.stringsBundle = @"MyCustomBundle";

config.stringsBundle = "MyCustomBundle"

Observação: 
1. O nome do pacote diferencia maiúsculas de minúsculas 
2. A extensão .bundle não é necessária

8. Personalização

8.1 Opções de personalização da interface do usuário

Modifique nosso arquivo de tema padrão FCTheme.plist para personalizar a interface ou você pode vincular seu próprio tema personalizado

arquivo para o SDK usando o trecho de código a seguir.

Objetivo C

[config setThemeName:@"<Theme_Name>"];

config.themeName = "<Theme_Name>"

[Freshchat sharedInstance].customLinkHandler = ^BOOL(NSURL * url)
{ //Your code for handling link within app, forwarding link to another
viewcontroller        return YES; //Return "NO" if you want to open the link in the default browser like
Safari.

};

Freshchat.sharedInstance().customLinkHandler = ({ (url) in 
//Your code for handling link within app, forwarding link to another
viewcontroller
       return true

//Return "false" if you want to open the link in the default browser like
Safari.

})

9. Outras Notas

9.1 Lista de Verificação para Lançamento

1. Certifique-se de ter o SDK mais recente.

2. Certifique-se de inicializar o SDK ao iniciar o aplicativo: didFinishLaunchingWithOptions: function.

3. Verifique se a notificação por push está funcionando corretamente quando o aplicativo está em primeiro plano, segundo plano e no estado eliminado com o certificado de produção.

4. Veja nosso documento de temas e personalização aqui para garantir que você está combinando a experiência com o resto do seu aplicativo.

5. Configure o nome do tópico padrão e a mensagem de boas-vindas, mesmo se você não estiver usando outros tópicos.

6. Capture o identificador exclusivo do usuário, e-mail, número de telefone ou qualquer outro identificador exclusivo do cliente com o SDK para garantir o uso tranquilo das APIs, bem como para o melhor uso do nosso recurso "Smart Plugs" no painel.

7. Certifique-se de que as notificações por push estejam funcionando para novas instalações, bem como atualizações de suas versões anteriores.  

9.2 Compatibilidade com iOS 10

A partir do iOS 10, a Apple exige que os desenvolvedores declarem o acesso a controles sensíveis à privacidade com antecedência. 

Para atender a esse novo requisito de privacidade, os desenvolvedores devem adicionar as chaves necessárias ao Info.plist, 

"NSPhotoLibraryUsageDescription" e "NSCameraUsageDescription" 

Além disso, também registraremos uma mensagem de aviso no console do XCode se você não tiver adicionado as chaves necessárias. 

Aviso!

Se isso falhar, o iOS 10 sairá do aplicativo travando quando um usuário tentar acessar os controles do microfone, câmera ou biblioteca de fotos. 

Para mais informações, clique aqui .  

9.3 Problema do simulador do iOS 10  

O SDK do Freshchat depende dos serviços de chaves. Os simuladores Xcode 8.0 (8A218a) / iOS 10 têm um problema com os serviços de chaves, que não permitem que o SDK recupere dados da loja quando não há "direitos" configurados. Para corrigir isso na página de recursos do projeto, ative o recurso de notificações por push (e selecione "corrigir problema" se algum problema aparecer). Esta é uma solução alternativa para garantir que haja um arquivo de autorização válido para o projeto (que o simulador requer para funcionar corretamente) e, uma vez que o teste seja concluído, você pode descartar essas alterações.

Hospedamos um projeto de amostra que você pode usar para experimentar nossas APIs de SDK. 

Ele pode ser acessado no seguinte link: https://github.com/freshdesk/freshchat-ios/tree/master/Sample