Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 90 Next »

Table of Contents:


The Ongage Webhook

Intro

  • When this feature is set in your account, the Ongage platform will forward all hard bounces, soft bounces, unsubscribes, and complaints, automatically from Ongage to your CRM/Data Warehouse/Back-end system.
  • This is a "Push" feature, designed for pushing the above to an endpoint on your side, instead of you having to "Pull" this data from Ongage, by implementing the Ongage API.
  • Go to your 'Account General Settings'  under the 'Account Settings ' menu item. Go to the Webhook endpoint URL input field, and enter an endpoint URL to where Ongage should push this data.

The post command to your endpoint 

Ongage will issue an HTTP Post call to the endpoint URL you provide with an accompanying JSON as in the following format example:

[  
   {  
      "email":"email1@email.com",
      "list_id":9997,
      "status":"unsubscribe",
      "esp_name" : "Amazon SES"
   },
   {  
      "email":"email2@email.com",
      "list_id":9998,
      "status":"soft",
      "esp_name" : "Amazon SES"
   },
   {  
      "email":"email3@email.com",
      "list_id":9998,
      "status":"hard"
      "esp_name" : "Amazon SES"
   },
   {  
      "email":"email41@email.com",
      "list_id":9994,
      "status":"complaint"
      "esp_name" : "Amazon SES"
   }
]

How to read the data from your endpoint 

To read the data on your end you'll need something like the following PHP code example

$someArray = json_decode(file_get_contents("php://input"), true);

Here are 2 PHP code examples if you'd like to simulate this on your end:

  1. request.php
  2. response.php

Available status values

The status parameter above can contain any of the following values:

  1. soft
  2. hard
  3. unsubscribe
  4. complaint

Additional technical details

  • If the call to your web-service fails, Ongage will save the call and retry again later.
  • Ongage will call the web-service you provide every 10 minutes with all the bounces, unsubs, and complaints that accumulated in that time interval.


Two Factor Authentication Login

For customers interested in switching on this enhanced security login feature, please contact Ongage Support and/or your Ongage account manager.
To be noted this is an account setting, meaning it will apply to all users of a given account once set on (there is no possibility to set this on a per user basis within an account).

  1. Once switched on, then everytime, one of your users attempts to login to your Ongage account, they will be displayed a 2-Factor login form:


  2. If you don’t already have, then you will need to download to your mobile phone: Google Authenticator, Authy Authenticator or any other Authenticator app out there. These apps are available for iOS and Android.

  3. Then with one of the autheticators, scan the QR code and type in the 6 digit code (this code changes every 15 seconds). You will only need to do this step once.


  4. From that point on every time you login, simply open the Authenticator app on your mobile phone, and type in the current code as it is displayed in the app.

(info) Note: should you change or loose your phone, you will need to rescan the QR code. Resetting your password also resets the QR code as well.



  • No labels