SMS Webhook

NOÉ lets you use a webhook to send bulk SMS through your own SMS sending service. This gives you full control over the sending provider and associated costs.

How it works

When an organizer clicks the bulk SMS button, NOÉ sends a POST request to the URL you configured in your event's advanced settings.

Method

POST

Request body

{
  "phoneNumbers": ["+33612345678", "+33698765432"],
  "textMessage": "Hello! Reminder for the session...",
  "senderRegistration": {"...": "sender's registration info"},
  "session": {"...": "session information"},
  "registrations": [{"...": "list of registrations"}]
}

Field details

Field	Description
phoneNumbers	List of recipients' phone numbers.
textMessage	The text message to send. The sender can modify it before sending.
senderRegistration	Information about the registration of the person sending the SMS (name, email, etc.).
session	Information about the session (name, dates, times, location, etc.), without the participant list.
registrations	The full list of registrations for this session, with their form answers.

Message customization

The default message is based on the SMS message template configurable in your event settings. The sender can freely edit the text before sending.

Request mode

The request is sent in mode: "no-cors". This means that:

• NOÉ cannot read your server's response.
• The send is considered successful once the request has been dispatched.
• Your service must accept CORS requests from your NOÉ instance origin.

Security

Webhooks and security

As with NOÉ's classic webhooks, SMS webhooks are not secured by default. We recommend using IP address filtering to verify that requests actually come from the NOÉ server.