Sendoso helps organizations to build real relationships and reward employees at scale with their Sending Platform.

This document describes steps to enable OAuth2 authentication and how to send gifts using Sendoso API through Enboarder. You will need to be a Sendoso customer and administrator to complete the integration. For more information see https://sendoso.com/hr-and-more-teams/

Before you begin: Like anything worth doing, integrations take time. Please allow up to 4 weeks for this integration to be completed, this includes time for scoping, development and testing. You’ll also need to have a system expert and/or system administrator to assist in the completion of this integration.

Setting up the Sendoso Tile 

Here are the steps for Integration:

  • Login as admin user and go to Settings → Integration → App center

  • Click on the tile Sendoso (or search if you can't see it) for which you want the integration setup.

  • Click on Add Integration button:

  • On the next screen, enter the env prefix. Sendoso has 3 env, please enter a right prefix and click next

Production Environment: app

  • On the next screen,  click on Integrate Now button

The system will redirect you to Sendoso site, enter your Sendoso credential.

Once logged in, a request for information access will be asked. Once this is allowed, the customer instance will be set up, and the integration is completed.

The system will show tile as integrated:

Send an e-gift using webhook

Basic information required  to send a gift

Before sending a gift using API, please log in your Sendoso account and note down below information

  • TouchID

  • The amount allocated to touch

Login in your account and go to https://app.sendoso.com/touches

Click on Edit and you will find the TouchID in the URL. Copy the URL as below:

Then click on the next step button to see the next page. On this page, please note down the amount of gifts.

There are two options. Either there will be default amount:

or range of amount for gift:

In the second case the value of the amount should be either Minimum or Maximum

Gifts API

Sending e-gift to a single recipient 

URL - https://app.sendoso.com/api/v3/send.json

Sample Payload:  

Please change the amount and touch id based on requirements. 

{
  "send": {
    "via": "single_email_address",
    "amount": 25,
    "touch_id": 4856,
    "via_from": "{{direct_manager_email}}",
    "email": "{{newhire_email}}",
    "custom_message": "Hi {{newhire_name}}, Here is your coffee coupon"
  }
}

Note- The custom_message is optional.

Response:

On Successful you will get the below response

{
    "success": true,
    "message": "EGifts send Successfully",
    "tracking_code": "c65f6ef000a889efc64cd133f204e47175a4d416",
    "tracking_url": "https://staging.sendoso.com/track/c65f6ef000a889efc64cd133f204e47175a4d416"
}

Sending e-gift to multiple recipients

URL - https://app.sendoso.com/api/v3/send/bulk_email_addresses

Sample Payload:  

Please change the amount and touch id based on requirements. 

{
    "send":
       {
          "via": "bulk_email_addresses",
          "touch_id": 4853,
          "amount": 5,
          "via_from": "{{direct_manager_email}}",
          "message_from": "CSV",
          "recipient_users":
              [
                  {
                     "first_name": "{{newhire_name}}", "email": "{{newhire_email}}", "custom_message": "Hi {{newhire_name}}, here is coupon for coffie"
                  },
                  {
                     "first_name": "{{buddy_name}}", "email": "{{buddy_email}}", "custom_message": "Hi {{buddy_name}}, here is your Starbuck coupon"
                  }
              ]
       }
}

Note- The custom_message is optional.

Response:

On Successful you will get below response

{
    "success": true,
    "message": "Bulk coffee sending in progress, this may take a little time. You'll see it in Activity shortly."
}

Sending a physical gift to the recipient

URL - https://staging.sendoso.com/api/v3/send.json

Sample Payload:  

Please change the amount and touch id based on requirements. 

{
  "send": {
    "via": "single_person_or_company",
    "touch_id": "1076",
    "name": "{{newhire_name}}",
    "address": "{{form / welcomeform / address}}",
    "address1": "{{form / welcomeform / address1}}",
    "city": "{{form / welcomeform / city}}",
    "state": "{{form / welcomeform / state}}",
    "country": "{{form / welcomeform / country}}",
    "zip": "{{form / welcomeform / zip}}",
    "via_from": "{{manager_name}}",
    "email": "{{newhire_email}}",
    "custom_message": "Hi {{newhire_name}}, Happy remote onboardering, here is your welcome kit..."
  }
}

Note- The custom_message is optional.

Response:

On Successful you will get the below response

{
    "success": true,
    "message": "Gifts send Successfully",
    "tracking_code": "c65f6ef000a889efc64cd133f204e47175a4d416",
    "tracking_url": "https://staging.sendoso.com/track/c65f6ef000a889efc64cd133f204e47175a4d416"
}

Webhook setting

While configuring webhook, please select authentication as Sendoso and remove any additional header/key row

References

Authorization with OAuth2 flow

https://sendoso.docs.apiary.io/#introduction/the-api/authorizing-your-connection

Send Gift

https://sendoso.docs.apiary.io/#reference/send-management/send-a-gift/sending-a-gift

Send Gift to multiple recipients 

https://sendoso.docs.apiary.io/#reference/send-management/bulk-sending/send-a-bulk-group-of-e-gifts

How to create a touch
https://sendoso.zendesk.com/hc/en-us/articles/115006881487-How-to-create-a-Touch 

Did this answer your question?