Wiraya Communication API
Getting started with the Wiraya API
Introduction This introduction is intended for commercial teams and tech teams and explains what WAI is, why you should be using it and how to integrate it into your existing marketing stack. WAI is the next generation of our mobile customer activation platform where we’ve taken all the knowledge we gained during the previous 7+ years doing customer communications and combined that with the data of 100 million+ customer interactions we’ve executed for clients. This combination of expert humaPopularAPI Specification
The API aims to allow our clients to build technical integrations where their systems communicate directly with the Wiraya platform in order to use Wiraya Activation Intelligence. If you're missing some feature or have any questions, please let us know! Syntax and interoperability The API is structured as a RESTful endpoint, meaning that the URL encodes the resource and the HTTP method defines the action. As an API primarily intended for data ingress, there’s no implementation for DELETE oPopularNaming Conventions
For the Contact, Events, and Metrics entities a common name standard should be used to secure proper usage of the values in analytics and reporting. The names are case sensitive. Business specific naming convention rules are listed as separate subsections. Contacts Personal (https://downloads.intercomcdn.com/i/o/134333451/6cb6da00bfc49d26544d0d3e/Ska%CC%88rmavbiPopularAPI Reference
If you are looking for our API Reference head this way.Some readersData feedback
For more information go here.Few readers
Wiraya Integrations
Send SMS over our REST API
Our platform offers flexible solutions for your SMS communication needs. Whether you're sending a single message or managing large-scale campaigns, we've got you covered. Here are the ways you can integrate SMS sending functionality into your operations: Authentication Authenticate with X-ApiKey in the header 1. Sending Individual SMS Messages Ideal for personalized, one-off messages, this method allows you to specify the sender, recipient, and message content for each SMS. This approaSome readersSMS Regulations/Information
🇦🇷 Argentina MCC: 722 Dialing code: +54 Sender availability: Short Codes (shared available immediately, dedicated takes up to 3 months). Country regulations: Avoid using bank and mobile operator names to prevent spam filtering. Country restrictions: Gambling, political, and adult content is forbidden. Cross-operator promotions are blocked. Recommendations: Use international phone number format. Avoid adding digits like '9' or '15'. 🇦🇺 AustraliaFew readersRegister alphanumeric sender
To be able to use alphanumeric sender, sender needs to be registered in the following countries: Abkhazia Afghanistan Algeria Armenia Bangladesh Belarus Bosnia and Herzegovina Canada Chad Congo, Democratic Republic of Cuba Cyprus Czech Republic Egypt El Salvador France Georgia Guatemala Honduras Hong Kong India Indonesia Iran Israel Jordan Kazakhstan Kenya Kuwait Kyrgyzstan Laos Malaysia Mexico Montenegro Morocco NamibiaFew readersCommunication callbacks via REST
Communication callbacks are sent out from the Wiraya platform retroactively several times per minute, and can deliver data for events regarding incoming and outgoing SMSes and phone calls. The receiving endpoint must support HTTPS and TLSv1.2. Self-signed certificates are permitted. Batched requests, basic access authentication, client certificates and customized headers are supported. Requests can be sent as GET, or as POST with a customized JSON or XML body. Customers may customize the callbaFew readersAdd contact to a Communication Flow
The flow for adding a contact to a communication flow is as follows: Authenticate Add the contact to our system Connect contact to the correct communication flow When a contact has made a conversion or opt-out, send us an event Read more about the API here 1. Authentication 2. Add contactFew readersOptimove Integration
Running a Wiraya campaign in Optimove Once the Wiraya integration is up and running and the Wiraya communication journeys are loaded by the Wiraya onboarding team, follow these simple steps to target your customers. In Optimove Create a Target Group selecting the customers based on your criteria. Use the Campaign Builder to schedule the campaign to run daily. The Wiraya communication is preconfigured to communicate on your preferred days and hours. In the Execution details, simpFew readersSMS Basics
Sender Name The GSM standard for sender name specifies that it should be between 3 and 11 characters long, and can only contain A-Z, a-z, and 0-9. Although it may be possible to use fewer than 3 characters or other characters, Wiraya does not recommend this and will not take responsibility for any issues that arise. Characters and SMS length We support GSM 03.38 and UCS-2 character sets for sending SMS messages. A message sent using the GSM 03.38 character set can contain up to 160 charFew readersEnqueue Communications API Documentation
📘 Overview The EnqueueCommunications API allows you to queue messages for delivery. It’s used to schedule communications with recipient information and message content, which the system will later process and send. 🔗 Endpoint URL: https://api.wiraya.com/api/EnqueueCommunications Method: POST Accepted Content Types (Request): application/json text/json application/xml text/xml application/x-www-form-urlencoded Supported Response FormatsFew readers
Wiraya Customer Data Transfer
Link track information
Short version: Wiraya Link Tracker Link tracking with CNAME redirection on a subdomain A Link Tracker is a tool that lets Wiraya Cloud keep tabs on individual web links, especially in SMS messages. It generates personalized short links with unique identifiers. When someone clicks, Wiraya Cloud knows who it is, records the action, and then takes them to the destination. This helps Wiraya Cloud report actions improve messaging and conversion rates. How does it work? The Wiraya LSome readersCustomer Service Connection
Wiraya needs Minimum 1 number to connect customers directly through to customer service (e.g. via key choice 1 ) This number should be a specific number for Wiraya customers and preferably marked clear for customer service agents Number for customers to call from the SMS (can be same as above, can be new specific number, or a general customer service number) Opening hours for the numbers above Client should decide if they would like to see customers mobile number or Wiraya's outgoing nFew readersSFTP Configuration
How to upload files to Wirayas sFTP File requirements Introduction You can either automate or manually upload contact lists to our sFTP server. If you upload the list daily, we recommend using a script to export the list to the sFTP server. This document will provide instructions on how to manually access the sFTP server for uploading contact lists. 1.1 Requirements Access to the sFTP server requires an FTP-client. We suggest using a freeware program like FileZilla, especially if you'Few readers