SMS verification using Bird

SMS verification is used as an extra security layer for secure tickets. It makes sure that the SMS code that unlocks the e-tickets is sent to the mobile telephone number that was used during the ticket order process, making sharing of e-tickets more difficult for scalpers.

SMS Setup in Bird

Step 1: Create a Bird account

1. In the What brings you to Bird? screen, select Development APIs

 

2. In the What integration type are you building? screen, select Direct integration

 

3. In the What development apprach do you want to take? screen, select APIs

 

4. In the What use case are you building? screen, select OTP

 

5. In the What channel are you interested in? screen, select SMS

 

Step 2: Add balance to your wallet

1. Follow the link “Add balance to your wallet” at the top of the screen:

2. Add an amount and run through the payment process. For an initial test, make sure you move a couple of euro’s into your wallet.

Step 3: Creating a Workspace

1. On the main screen, select Workspaces to create a new workspace.

2. Add a new Workspace. Give it any name that makes sense to you.

3. Click the “edit” ✏️ icon to open the workspace settings pop-up.

4. Copy the Workspace ID.

Step 4: Create an API key

1. Go to the Developer section (the blue icon) and select API Access Keys

 

 

2. Create a new API key

 

3. Give the key a name, and check the box Verify API access

 

4. Copy the API key from the pop-up screen.

 

Step 5: Set up an SMS Channel

1. Go to the Development tab (blue icon)

2. In the SMS menu section, select SMS setup

3. Click the blue Setup SMS channel button.

4. Select the country of operation and click Continue

 

5. Select Authentication

 

6. In the Alphanumeric field, fill in a sender name you would like people to see when receiving your SMS (max 11 characters). Click Continue.

 

 

7. Check the acknowledgement box at the bottom of the screen and select finish.

 

Step 6: Active your Channel

Open the Brand Identification form. Fill in your company data in the form and click Submit for approval.

 

1. Select usecase “2FA” [2 factor authentication]

2. Fill out the Description. Use something like “We will send a code by SMS to unlock e-tickets”

3. Provide an example message. This does not need to be exact, as CultureSuite manages the message text when sending. Fill in “This is your code [code]” as an example of what kind of SMS you will be sending.

4. Click Create UseCase.

In the pop-up, find the Channel ID and copy it.

 

Send a test SMS

1. In the Developer menu, go to step 3 Send your first SMS.

2. Select your Alphanumerical Sender label, fill in your mobile phone number for a test and click Send test SMS.

API settings in CultureSuite CMS

1. In your CultureSuite CMS - Go to System > API connections and select Add to create a new API connection

2. Type = Messaging

3. Group = messagebird

4. Keyname/subkeyname should stay “default”

5. url should always be https://api.bird.com

6. Fill in your workspace_id

7. Fill in your API key

8. Fill in your channel_id

9. Save

How to Activate SMS validation per event

• In your Dashboard, go to Events & Productions > Events and open the Event you want to add SMS verfication to.

• Make sure your event has the setting SMS verification checked. Visitors will be prompted to enter their mobile number during the order process.

• You also can change the Max tickets per order here for the event.

• Got to System > Control Panel > E-tickets

• Set the checkbox Secure e-tickets if you want to disable direct e-ticket access from the email link by asking the visitor to log into their account. This also enables the option to show the e-tickets only just before the start of the event.

Activating Dynamic barcodes

Ovatic set-up

• In Ovatic, the event needs to have the option “smart tickets” activated.

• In your CultureSuite dashboard, The “Smart Tickets Integrator Secret” needs to be configured. You can get a secret from Ovatic. This is unique for each website. Configure the secret in /dashboard?cat=control_panel&action=check&module_code=OVATIC_CONNECTOR

• In the same module, configure the “Smart Tickets Origin Identifier” you can also get from Ovatic.

Itix set-up

• In your CultureSuite dashboard, The “Smart Tickets Integrator Secret” needs to be configured. You can get the secret from Itix. Configure the secret in /dashboard?cat=control_panel&action=check&module_code=ITIX_CONNECTOR

• In Itix the option “Secure tickets” needs to be set.

Testing SMS and Dynamic Barcodes

What to do if SMS Fails