• Features
  • Marketplace
  • API Docs
  • Help Center
  • Log in
  • Sign Up
  • Features
  • Marketplace
  • API Docs
  • Help Center
  • Log in
  • Sign Up

Webhooks

817 views November 22, 2018 0

A webhook is an HTTP callback that allows a web application to POST a message to a URL when certain events take place. Often called “Reverse APIs,” Webhooks can be used to receive data in real time, pass it on to another application, or process the data faster than traditional APIs.

The Webhook notifies the URL via HTTP POST about events that take place with your email in the SmartSender.io platform. The Webhook then captures email-specific data related to unsubscribes, spam reports, bounced emails, and response data, and reports them in the manner in which you specify.

Step-by-step instructions:

  1. Navigate to Webhook management page (Menu -> Integrations).
  2. Select the “Webhooks” section.
  3. Press the “Create ” button.
  4. Type the title of the webhook in the “Name” field.
  5. Select the Project Domain.
  6. Type in the URL, to which a message should be posted.
  7. Select one or several events.
  8. Click on the “Create” button.

The list of earlier created webhooks will be seen on the Webhooks page.

Events and triggers you are able to choose:

    • Email
      Email Description
      Message Status Message is Delivered The Delivered status is assigned as soon as
      the message sent by SmartSender was accepted by the recipient’s ISP
      server
      Message is Rejected The message has been rejected by ESP.
      Message is Bounced The time and hard-bounce code received from the
      ISP. A hard bounce indicates a permanent reason why an email cannot be
      delivered. Hard bounced email addresses are immediately automatically placed
      in the sender’s account BlackList to
      prevent degradation of the sender’s domain reputation.
      Contact Event Contact Subscribes To Email The contact confirmed that agrees to get
      emails.
      Recipient Unsubscribes From Email This action unsubscribes the recipient from a
      specific channel.
      Contact Activated The contact will be activated in the Contact
      List.
      Contact Deactivated The contact will be deactivated in the Contact
      List.
      Contact unsubscribes using List-Unsubscribe
      technology
      The contact pressed the Unsubscribe Link inside
      the message. That contact is automatically moved to the BlackList.
      Message Event Message Is Read The read status is assigned every time this
      message has been opened by the user. The message includes information on
      each read.
      Message Is Clicked The click status is assigned every time tracked
      URLs in this message have been clicked by the user. The message includes
      information on each click.
      Message Is Marked As Spam The recipient moved the message from Inbox to
      the Spam folder. Messages from the same sender might be sent to Spam in
      the future.

       

    • SMS
      SMS Description
      SMS is Delivered The carrier server accepted & queued for delivery this message.

       

    • WebPush
      WebPush Description
      Message Status WebPush Notification Is Delivered The WebPush notification has reached the recipient’s browser.
      WebPush Notification Undelivered The Push notification wasn’t delivered, an invalid token.
      WebPush Notification Is Expired by TTL The Push notification wasn’t shown due to TTL (Time to live).
      Contact Event WebPush Desktop Permission Is Declined The recipient has explicitly denied permission to show notifications.
      WebPush Desktop Permission Is Granted The recipient has allowed permission to display Desktop WebPush notifications, after having been asked previously.
      WebPush Desktop Is Unsubscribed The recipient dismissed the permission to get WebPush Desktop notifications.
      WebPush Mobile Permission Is Declined The recipient dismissed the permission to get WebPush Mobile notifications.
      WebPush Mobile Permission Is Granted The recipient has allowed permission to display Mobile WebPush notifications, after having been asked previously.
      WebPush Mobile Is Unsubscribed The recipient dismissed the permission to get WebPush Mobile notifications.
      Message Event WebPush Notification Is Clicked The recipient followed a link in the content of the WebPush Notification.
      WebPush Notification Is Displayed The WebPush Notification is shown on the recipient’s device.
      WebPush Notification Is Closed by User The WebPush Notification is shutted down by the recipient.

       

    • Telegram
      Telegram Description
      Message Status Telegram Message is delivered The message has reached the recipient’s Telegram.
      Telegram Message is failed The Telegram message delivery was not successful.
      Contact Event Contact subscribed to telegram bot The contact launched the /start command to agree for getting mailing.
      Contact unsubscribed from telegram bot The contact launched the /end command to refuse for getting mailing.
      Contact subscribed to telegram channel The contact confirmed that agrees to get messages from the specific telegram channel.
      Contact unsubscribed from telegram channel The contact pressed the unsubscribe button to stop getting the messages from the specific telegram channel.
      Message Event Telegram Message is viewed The recipient opened the channel and reached the specific message or marked it as read.
      Telegram Message is clicked The recipient followed a link in the content of the Telegram Message.

       

Successful. 200 – OK. The 200 status code means that the request was received and understood and is being processed.

If the webhook delivery fails, we will make 15 attempts to deliver the webhook before dropping it from the queue:

Number of attempts Seconds between attempts
3 100
6 600
6 3600
Similar posting
  • User
  • Account
  • Allowed IPs/IP Addresses
  • Subaccounts
  • Security
  • Integration with Mailchimp
Company
  • About us
  • Team
  • YouTube
  • Facebook
  • Google Business
Legal
  • Terms of Use
  • Privacy Policy
  • Anti-Spam Policy
  • Cookie Statement
Resources
  • Api Documentation
  • FAQ
  • Knowledge Base
  • SmartSender Blog
  • Marketplace

We use cookies to make SmartSender’s website a better place. Cookies help to provide a more personalized experience for you, and web analytics for us. To learn more, and to see a full list of cookies we use, check out our Cookie Policy (baked goods not included).

got it