Send an SMS survey using a webhooks API call

Send an SMS survey using a webhooks API call

SightMill provides a webhooks API to allow you to integrate to other platforms such as a CRM, helpdesk or Zapier, and automatically send SMS surveys from SightMill in response to an event.
A typical example used by many of our customers is to integrate SightMill with their helpdesk (for example, Zendesk) to automatically send an SMS survey when a support ticket has been closed.
The SMS webhooks API is easy to setup.

  1. In SightMill, go to the Projects/Settings/Webhooks menu item
  2. Make sure you toggle the first option to enable webhooks to 'on'
  3. Copy your unique SMS webhooks URL (the fifth option down)
  4. Now in your other platform, for example Zapier.com, go to the webhooks settings page (in Zapier, use the 'webhooks by Zapier' application)
  5. Choose to POST operation
  6. Paste in the unique URL you copied in step three
  7. Now add in the data you want to send to SightMill. This must include the mobile phone number and can also optionally include any tags (the field names are phonenumber and tags).
Make sure that the mobile phone number is formatted with + then country code then the number (with no leading zero, no spaces, no hyphens). eg: a UK mobile number 0774 123 1234 would be sent as +447741231234.
 
Here's an example of the POST format and two data fields:

POST https://sightmill.com/hooks/123AAA/survey/sms
{
"phonenumber": "+447741231234",
"tags": "tag1, tag2"
}

Note: If you are a developer, the response code from SightMill for a successful survey is 200. 

    • Related Articles

    • Send an NPS survey by SMS text message

      Creating a text-message or SMS survey lets you gather surveys directly from customers who can communicate using their phone and text messaging. It's very straightforward to setup using SightMill: follow these simple steps and you'll have a tailored ...

    • How many SMS surveys can I send?

      The number of SMS surveys you can send per month is linked to your subscription plan (to check your current paid plan, login to your account and view your Plan page or visit our pricing page for details of the surveys per month for each plan). There ...

    • Add a new SMS phone contact manually

      You can add new SMS/text message contacts manually using our pop-up form – it’s a great way for telephone support teams to record feedback during a call or to to add new customers one at time rather than having to setup a CSV upload.  Here's how: To ...

    • How does someone unsubscribe from an SMS survey?

      A recipient can unsubscribe from your SMS survey by replying to the first SMS message with 'STOP' or 'UNSUBSCRIBE'. SightMill changes this recipient to 'unsubscribed' and does not record any score or free text. The recipient can subscribe again by ...

    • Can I use an alpha sender ID / short code / alphanumeric name when sending SMS surveys?

      SightMill does not support alpha sender IDs (also known as short codes) to represent the sender's name instead of a normal phone number. Many countries support alpha sender IDs instead of mobile phone numbers. This will show up on a recipient's ...