messente_api 1.0.3 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28da361ef84b6ebe8eb42057099d445a92b550c031c8ca6b03a5048a7aa4eed6
-  data.tar.gz: 54a595e25757abfeb29ef794d2c752264ef08d381692e0f541f8b33f7ffb1624
+  metadata.gz: ae129fcfa84dfc242304b6dc38c18cee5237972956bd296ff7e18a19fa325b29
+  data.tar.gz: 91a8394d2af1ee739b39dba6026521ef0717577203f19455a0dc218596b0abb0
 SHA512:
-  metadata.gz: 9d7b4c14e2f7c4a8bb75e81115c8e84b3fdf8ddb9171f822883cb4dd5d8fc4d6e73c9ffb4506d7c9f289f5509b19571d4e2c08772b4706cbbbf74f262481936b
-  data.tar.gz: 437ce78c918c1c0e0caf8a0b4ae326ed45f89e88ada2df99a1b6ed109aba7a222f2e9b303b8dcccd3fc322b32684241e35525c228fff37fbf31c89e92476ff10
+  metadata.gz: ac291d861d0e16e6ca79e5b1125e4bb0193635979cccaffde4d4b75a334704fd08d446332c5652de4b2aa07c9efa673614207e5997af84c51fe9c0b7687a4b2a
+  data.tar.gz: ea4546e0d9f950fa9e62b51777dacaf974e98e401e1b013bce4fdbe16cb39bc912e58553031480befef2305f466bc6431e0b35c5d65df2cf8edcb856f9b5a42a

data/Gemfile

@@ -3,7 +3,7 @@ source 'https://rubygems.org'
 gemspec
 
 group :development, :test do
-  gem 'rake', '~> 12.0.0'
+  gem 'rake', '~> 13.0.1'
   gem 'pry-byebug'
   gem 'rubocop', '~> 0.66.0'
 end

data/README.md

@@ -1,9 +1,9 @@
 # Messente API Library
 
-- Messente API version: 1.0.2
-- Ruby gem version: 1.0.3
+- Messente API version: 1.3.0
+- Ruby gem version: 1.3.0
 
-[Messente](https://messente.com) is a global provider of messaging and user verification services. Use Messente API library to send and receive SMS, Viber and WhatsApp messages, blacklist phone numbers to make sure you're not sending any unwanted messages, manage contacts and groups.  Messente builds [tools](https://messente.com/documentation) to help organizations connect their services to people anywhere in the world.
+[Messente](https://messente.com) is a global provider of messaging and user verification services.  * Send and receive SMS, Viber, WhatsApp and Telegram 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](https://messente.com/documentation) to help organizations connect their services to people anywhere in the world.
 
 ## Installation
 
@@ -48,11 +48,19 @@ Messente API Library provides the operations described below to access the featu
 1. Returns all groups [`fetch_groups`](docs/GroupsApi.md#fetch_groups)
 1. Updates a group with the provided name [`update_group`](docs/GroupsApi.md#update_group)
 
+### NumberLookupApi
+
+1. Requests info about phone numbers [`fetch_info`](docs/NumberLookupApi.md#fetch_info)
+
 ### OmnimessageApi
 
 1. Cancels a scheduled Omnimessage [`cancel_scheduled_message`](docs/OmnimessageApi.md#cancel_scheduled_message)
 1. Sends an Omnimessage [`send_omnimessage`](docs/OmnimessageApi.md#send_omnimessage)
 
+### StatisticsApi
+
+1. Requests statistics reports for each country [`create_statistics_report`](docs/StatisticsApi.md#create_statistics_report)
+
 ## Auth
 
 **Type**: HTTP basic authentication

data/docs/ContactFields.md

@@ -14,6 +14,7 @@ Name | Type | Description | Notes
 **custom2** | **String** | The second custom field | [optional] 
 **custom3** | **String** | The third custom field | [optional] 
 **custom4** | **String** | The fourth custom field | [optional] 
+**scheduled_deletion_date** | **Date** | The date in ISO 8601 format, YYYY-MM-DD,  on which the contact is going to be deleted  because it has not belonged to a group for 30 days | [optional] 
 
 ## Code Sample
 
@@ -29,7 +30,8 @@ instance = MessenteApi::ContactFields.new(phone_number: null,
                                  custom: null,
                                  custom2: null,
                                  custom3: null,
-                                 custom4: null)
+                                 custom4: null,
+                                 scheduled_deletion_date: null)
 ```
 
 

data/docs/ContactsApi.md

@@ -87,7 +87,7 @@ MessenteApi.configure do |config|
 end
 
 api_instance = MessenteApi::ContactsApi.new
-contact_fields = {"phoneNumber":"+37251000000","email":"anyone@messente.com","firstName":"Any","lastName":"One","company":"Messente","title":"Sir","custom":"Any custom","custom2":"Any custom two","custom3":"Any custom three","custom4":"Any custom four"} # ContactFields | 
+contact_fields = {"phoneNumber":"+37251000000","email":"anyone@messente.com","firstName":"Any","lastName":"One","company":"Messente","title":"Sir","custom":"Any custom","custom2":"Any custom two","custom3":"Any custom three","custom4":"Any custom four","scheduledDeletionDate":"2020-08-31"} # ContactFields | 
 
 begin
   #Creates a new contact
@@ -396,7 +396,7 @@ end
 
 api_instance = MessenteApi::ContactsApi.new
 phone = '+37251000000' # String | A phone number
-contact_update_fields = {"email":"anyone@messente.com","firstName":"Any","lastName":"One","company":"Messente","title":"Sir","custom":"Any custom","custom2":"Any custom two","custom3":"Any custom three","custom4":"Any custom four"} # ContactUpdateFields | 
+contact_update_fields = {"email":"anyone@messente.com","firstName":"Any","lastName":"One","company":"Messente","title":"Sir","custom":"Any custom","custom2":"Any custom two","custom3":"Any custom three","custom4":"Any custom four","scheduledDeletionDate":"2020-08-31"} # ContactUpdateFields | 
 
 begin
   #Updates a contact

data/docs/ErrorCodeStatistics.md

@@ -0,0 +1,16 @@
+# MessenteApi::ErrorCodeStatistics
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::ErrorCodeStatistics.new()
+```
+
+

data/docs/ErrorItemNumberLookup.md

@@ -0,0 +1,17 @@
+# MessenteApi::ErrorItemNumberLookup
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**error** | [**ErrorItemNumberLookupError**](ErrorItemNumberLookupError.md) |  | 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::ErrorItemNumberLookup.new(error: null)
+```
+
+

data/docs/ErrorItemNumberLookupError.md

@@ -0,0 +1,19 @@
+# MessenteApi::ErrorItemNumberLookupError
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**description** | **String** | Error description | 
+**code** | **Integer** | Matches the following error title.   This field is a constant  * 101 - Unauthorized * 102 - Invalid arguments or parameters * 103 - Server error * 104 - Crediting error #1 * 105 - Crediting error #2 * 106 - Client error | 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::ErrorItemNumberLookupError.new(description: null,
+                                 code: null)
+```
+
+

data/docs/ErrorItemStatistics.md

@@ -0,0 +1,21 @@
+# MessenteApi::ErrorItemStatistics
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**title** | **String** | Error title | 
+**details** | **String** | Error details | 
+**code** | [**ErrorCodeStatistics**](ErrorCodeStatistics.md) |  | 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::ErrorItemStatistics.new(title: null,
+                                 details: null,
+                                 code: null)
+```
+
+

data/docs/ErrorNumberLookup.md

@@ -0,0 +1,17 @@
+# MessenteApi::ErrorNumberLookup
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**errors** | [**Array<ErrorItemNumberLookup>**](ErrorItemNumberLookup.md) | An array of errors | 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::ErrorNumberLookup.new(errors: null)
+```
+
+

data/docs/ErrorStatistics.md

@@ -0,0 +1,17 @@
+# MessenteApi::ErrorStatistics
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**errors** | [**Array<ErrorItemStatistics>**](ErrorItemStatistics.md) | An array of errors | 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::ErrorStatistics.new(errors: null)
+```
+
+

data/docs/MobileNetwork.md

@@ -0,0 +1,25 @@
+# MessenteApi::MobileNetwork
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**mccmnc** | **String** | Mobile country and mobile network code | [optional] 
+**network_name** | **String** | Mobile network name | [optional] 
+**country_name** | **String** | Country name | [optional] 
+**country_prefix** | **String** | Country prefix | [optional] 
+**country_code** | **String** | Country code | [optional] 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::MobileNetwork.new(mccmnc: null,
+                                 network_name: null,
+                                 country_name: null,
+                                 country_prefix: null,
+                                 country_code: null)
+```
+
+

data/docs/NumberLookupApi.md

@@ -0,0 +1,60 @@
+# MessenteApi::NumberLookupApi
+
+All URIs are relative to *https://api.messente.com/v1*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**fetch_info**](NumberLookupApi.md#fetch_info) | **POST** /hlr/sync | Requests info about phone numbers
+
+
+
+## fetch_info
+
+> SyncNumberLookupSuccess fetch_info(numbers_to_investigate)
+
+Requests info about phone numbers
+
+### Example
+
+```ruby
+# load the gem
+require 'messente_api'
+# setup authorization
+MessenteApi.configure do |config|
+  # Configure HTTP basic authorization: basicAuth
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = MessenteApi::NumberLookupApi.new
+numbers_to_investigate = {"numbers":["+37251000000","+37251000001"]} # NumbersToInvestigate | Numbers for lookup
+
+begin
+  #Requests info about phone numbers
+  result = api_instance.fetch_info(numbers_to_investigate)
+  p result
+rescue MessenteApi::ApiError => e
+  puts "Exception when calling NumberLookupApi->fetch_info: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **numbers_to_investigate** | [**NumbersToInvestigate**](NumbersToInvestigate.md)| Numbers for lookup | 
+
+### Return type
+
+[**SyncNumberLookupSuccess**](SyncNumberLookupSuccess.md)
+
+### Authorization
+
+[basicAuth](../README.md#basicAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/NumbersToInvestigate.md

@@ -0,0 +1,17 @@
+# MessenteApi::NumbersToInvestigate
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**numbers** | **Array<String>** | Array of phone numbers | 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::NumbersToInvestigate.new(numbers: null)
+```
+
+

data/docs/Omnimessage.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **to** | **String** | Phone number in e.164 format | 
-**messages** | [**Array<OneOfViberSMSWhatsApp>**](OneOfViberSMSWhatsApp.md) | An array of messages | 
+**messages** | [**Array<OneOfViberSMSWhatsAppTelegram>**](OneOfViberSMSWhatsAppTelegram.md) | An array of messages | 
 **dlr_url** | **String** | URL where the delivery report will be sent | [optional] 
 **text_store** | [**TextStore**](TextStore.md) |  | [optional] 
 **time_to_send** | **DateTime** | Optional parameter for sending messages at some specific time in the future.   Time must be specified in the ISO-8601 format.   If no timezone is specified, then the timezone is assumed to be UTC    Examples:    * Time specified with timezone: 2018-06-22T09:05:07+00:00 Time specified in UTC: 2018-06-22T09:05:07Z   * Time specified without timezone: 2018-06-22T09:05 (equivalent to 2018-06-22T09:05+00:00) | [optional] 

data/docs/OmnimessageApi.md

@@ -11,7 +11,7 @@ Method | HTTP request | Description
 
 ## cancel_scheduled_message
 
-> cancel_scheduled_message(omnimessage_id)
+> Object cancel_scheduled_message(omnimessage_id)
 
 Cancels a scheduled Omnimessage
 
@@ -32,7 +32,8 @@ omnimessage_id = 'omnimessage_id_example' # String | UUID of the scheduled omnim
 
 begin
   #Cancels a scheduled Omnimessage
-  api_instance.cancel_scheduled_message(omnimessage_id)
+  result = api_instance.cancel_scheduled_message(omnimessage_id)
+  p result
 rescue MessenteApi::ApiError => e
   puts "Exception when calling OmnimessageApi->cancel_scheduled_message: #{e}"
 end
@@ -47,7 +48,7 @@ Name | Type | Description  | Notes
 
 ### Return type
 
-nil (empty response body)
+**Object**
 
 ### Authorization
 

data/docs/StatisticsApi.md

@@ -0,0 +1,60 @@
+# MessenteApi::StatisticsApi
+
+All URIs are relative to *https://api.messente.com/v1*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**create_statistics_report**](StatisticsApi.md#create_statistics_report) | **POST** /statistics/reports | Requests statistics reports for each country
+
+
+
+## create_statistics_report
+
+> StatisticsReportSuccess create_statistics_report(statistics_report_settings)
+
+Requests statistics reports for each country
+
+### Example
+
+```ruby
+# load the gem
+require 'messente_api'
+# setup authorization
+MessenteApi.configure do |config|
+  # Configure HTTP basic authorization: basicAuth
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = MessenteApi::StatisticsApi.new
+statistics_report_settings = {"start_date":"2017-01-01","end_date":"2019-06-20","message_types":["sms"]} # StatisticsReportSettings | Settings for statistics report
+
+begin
+  #Requests statistics reports for each country
+  result = api_instance.create_statistics_report(statistics_report_settings)
+  p result
+rescue MessenteApi::ApiError => e
+  puts "Exception when calling StatisticsApi->create_statistics_report: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **statistics_report_settings** | [**StatisticsReportSettings**](StatisticsReportSettings.md)| Settings for statistics report | 
+
+### Return type
+
+[**StatisticsReportSuccess**](StatisticsReportSuccess.md)
+
+### Authorization
+
+[basicAuth](../README.md#basicAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/StatisticsReport.md

@@ -0,0 +1,21 @@
+# MessenteApi::StatisticsReport
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**total_messages** | **Integer** | Sum of all messages | 
+**total_price** | **String** | Price for all messages | 
+**country** | **String** | Target country of all messages | 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::StatisticsReport.new(total_messages: null,
+                                 total_price: null,
+                                 country: null)
+```
+
+

data/docs/StatisticsReportSettings.md

@@ -0,0 +1,21 @@
+# MessenteApi::StatisticsReportSettings
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**start_date** | **Date** | Start date for the report | 
+**end_date** | **Date** | End date for the report | 
+**message_types** | **Array<String>** | Optional list of message types (sms, viber, whatsapp, hlr, telegram) | [optional] 
+
+## Code Sample
+
+```ruby
+require 'MessenteApi'
+
+instance = MessenteApi::StatisticsReportSettings.new(start_date: null,
+                                 end_date: null,
+                                 message_types: null)
+```
+
+