messente_api

Messente API Library

• Messente API version: 2.0.0
• Ruby gem version: 2.4.1

Messente is a global provider of messaging and user verification services. * Send and receive SMS, Viber and WhatsApp messages. * Manage contacts and groups. * Fetch detailed info about phone numbers. * Blacklist phone numbers to make sure you're not sending any unwanted messages. Messente builds tools to help organizations connect their services to people anywhere in the world.

Installation

Install Messente API library with gem install messente_api.

Features

Messente API has the following features:

• Omnichannel (external docs),
• Phonebook (external docs).

Messente API Library provides the operations described below to access the features.

AccountBalanceApi

• Get account balance get_account_balance
• Get account balance get_account_balance_using_post

BlacklistApi

• Adds a phone number to the blacklist add_to_blacklist
• Deletes a phone number from the blacklist delete_from_blacklist
• Returns all blacklisted phone numbers fetch_blacklist
• Checks if a phone number is blacklisted is_blacklisted

BulkMessagingApi

• Sends a bulk Omnimessage send_bulk_omnimessage

ContactsApi

• Adds a contact to a group add_contact_to_group
• Creates a new contact create_contact
• Deletes a contact delete_contact
• Lists a contact fetch_contact
• Lists groups of a contact fetch_contact_groups
• Returns all contacts fetch_contacts
• Removes a contact from a group remove_contact_from_group
• Updates a contact update_contact

DeliveryReportApi

• Retrieves the delivery report for the Omnimessage retrieve_delivery_report

GroupsApi

• Creates a new group with the provided name create_group
• Deletes a group delete_group
• Lists a group fetch_group
• Returns all groups fetch_groups
• Updates a group with the provided name update_group

NumberLookupApi

• Requests info about phone numbers fetch_info

NumberVerificationApi

• verify number verify_number
• verified the PIN code entered by the user. verify_pin

OmnimessageApi

• Cancels a scheduled Omnimessage cancel_scheduled_message
• Sends an Omnimessage send_omnimessage

PricingApi

• Get pricelist for account get_pricelist
• Get pricing for a specific country get_prices

StatisticsApi

• Requests statistics reports for each country create_statistics_report

WhatsAppTemplatesApi

• Creates a WhatsApp template create_whatsapp_template
• Deletes a WhatsApp template delete_whatsapp_template
• Requests a WhatsApp template with the given ID get_whatsapp_template_by_id
• Requests a list of WhatsApp templates list_whatsapp_templates
• Updates a WhatsApp template update_whatsapp_template

Auth

Type: HTTP basic authentication

Read the external getting-started article which explains API keys and Sender ID logic.

Getting started: sending an omnimessage

require 'messente_api'

# setup authorization
MessenteApi.configure do |config|
    # Configure HTTP basic authorization: basicAuth
    config.username = '<MESSENTE_API_USERNAME>'
    config.password = '<MESSENTE_API_PASSWORD>'
end

api_instance = MessenteApi::OmnimessageApi.new
omnimessage = MessenteApi::Omnimessage.new
omnimessage.to = '<recipient_phone_number>'

sms = MessenteApi::SMS.new(
    sender: "<sender name (optional)>",
    text: "Hello SMS!"
)

viber = MessenteApi::Viber.new(
    sender: "<sender name (optional)>",
    text: "Hello from Viber!"
)

wa_parameters = [
  MessenteApi::WhatsAppParameter.new(type: 'text', text: 'hello whatsapp'),
]
wa_component = MessenteApi::WhatsAppComponent.new(type: 'body', parameters: wa_parameters)
wa_lang = MessenteApi::WhatsAppLanguage.new(code: '<language_code>')
wa_template = MessenteApi::WhatsAppTemplate.new(name: '<template_name>', language: wa_lang, components: [wa_component])
whatsapp = MessenteApi::WhatsApp.new(
    sender: '<sender name (optional)>',
    template: wa_template,
)

omnimessage.messages = [sms, viber, whatsapp]

begin
  result = api_instance.send_omnimessage(omnimessage)
  puts result
rescue MessenteApi::ApiError => e
  puts "Exception when calling send_omnimessage: #{e}"
  puts e.response_body
end

License

Apache-2.0

Terms

https://messente.com/terms-and-conditions