O evento personalizado é usado para criar notificações personalizadas entre o eCommerce e a Connectif. Ele notifica, via Mobile SDK, eventos da Integração personalizada para receber dados na Connectif, utilizando as funções Connectif.sendCustomEventById() e Connectif.sendCustomEventByAlias(), dependendo se queremos identificar eventos por alias ou id.
Como usar
A notificação de eventos de integração personalizada é realizada definindo o campo type com o valor literal "custom" e identificando o evento através do parâmetro eventAlias (único na sua loja). No parâmetro CustomEvent estarão, se houver, os campos do evento da integração.
Para construir o parâmetro CustomEvent, podemos usar classes que herdam de CustomEventValue, que correspondem aos tipos de campos que podem ser criados nos Eventos Personalizados a partir do Painel da Connectif.
CustomEventValue.Text
CustomEventValue.Phone
CustomEventValue.Email
CustomEventValue.Integer
CustomEventValue.Decimal
CustomEventValue.DateTime
CustomEventValue.Boolean
CustomEventValue.MultipleChoice
CustomEventValue.SingleOption
Exemplo usando alias do evento
Dada uma integração personalizada para receber dados, que é enviada quando um contato dá um Like a um produto, incluindo os campos email, productId.
A notificação terá este formato usando CustomEventValue:
Connectif.sendCustomEventByAlias("product-like", CustomEvent(values: [
"email": .email("test@example.org"),
"product-id": .text("+123456789")
])
Exemplo usando identificador do evento
Como alternativa ao uso do alias, é possível identificar o evento usando seu eventId. O exemplo a seguir demonstra como fazer isso (também compatível com o envio de campos como objeto anônimo):
Connectif.sendCustomEventById("635feb9a4168beeaf0ae6a46", CustomEvent(values: [
"email": .email("test@example.org"),
"product-id": .text("+123456789")
])
Callbacks (Opcional)
Se quisermos obter feedback sobre possíveis erros ao enviar eventos, podemos adicionar um EventCallbacks ao utilizar nosso método.
EventCallbacks(
onSuccess: {
//Processamento em caso de sucesso
},
onError: { error in
//Processamento em caso de erro
})
Parabéns!
Você chegou ao final da lição.
Ficou com alguma dúvida?
Lembre-se de que nossos especialistas na Connectif estão disponíveis para ajudá-lo. Para entrar em contato, basta abrir um ticket de suporte clicando no botão azul "Ajuda" no seu painel.
Continue aprendendo!
Para aproveitar ao máximo sua conta na Connectif, recomendamos continuar com os seguintes artigos:
- Android SDK Get Started, para adicionar o Connectif Mobile SDK ao seu projeto Android.
- Configuração do Firebase Cloud Messaging, para ativar o envio e recebimento de push via o Mobile SDK do Android.
- iOS SDK Get Started, para adicionar o Connectif Mobile SDK ao seu projeto iOS.
- Configuração do Apple Push Notifications Service, para ativar o envio e recebimento de push via o Mobile SDK do iOS.