README.md

Erlang Push Notifications - epns

epns is Erlang Push Notifications. This is a small client library for sending FCM/GCM/APNS Push Notifications

Goals

epns(Erlang Push Notifications) library aims to provide a simple way for push FCM/GCM/APNS notifications.

Documentation

Build & Run

$ git clone https://github.com/vkatsuba/shot.git
$ cd shot
$ wget https://s3.amazonaws.com/rebar3/rebar3
$ chmod u+x ./rebar3
$ ./rebar3 shell

Run dialyzer

$ ./rebar3 dialyzer

Run xref

$ ./rebar3 do xref

Clean epns

$ ./rebar3 clean

Add epns to project: Rebar3

• Edit file rebar.config:

{deps, [
    {epns, "1.1.0"},
]}.

Send Push Notifications

Send FCM by Erlang

%%% Useful links:
%%%  * https://firebase.google.com/docs/cloud-messaging/http-server-ref
%%%  * https://developer.clevertap.com/docs/find-your-fcm-sender-id-fcm-server-api-key

FCMData = #{
    key => "TheFcmServerApiKey",
    url => "https://fcm.googleapis.com/fcm/send",
    playload => #{
        to => <<"GoogleUserToken">>,
        priority => <<"high">>,
        data => #{
            <<"title">> => <<"Some Title">>,
            <<"some_custom_field">> => true
        }
    }
}.

epns:push(fcm, FCMData).

Send APNS by Erlang

%%% Useful links:
%%%  * https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CreatingtheNotificationPayload.html
%%%  * https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/BinaryProviderAPI.html
%%%  * https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/LegacyNotificationFormat.html

APNSData = #{
    cert => "/full/patch/to/cert.pem",
    key => "/full/patch/to/key.key",
    url => "gateway.push.apple.com",
    token => <<"VoipTokenOfUserDevice">>,
    playload => #{
        aps => #{alert => <<"Some Title Of Alert APNS">>},
        data => #{
            <<"title">> => <<"Some Title">>,
            <<"custom_field">> => <<"some_data">>
        }
    }
}.

epns:push(apns, APNSData).

Support

[email protected]