Odeslání sms kampaně.
XML-RPC žádost musí být vydána ve formátu uvedeném níže.
UPOZORNĚNÍ: Formát zasílaných dat musí být v Base 64.
<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
<methodName>mailkit.sendsms</methodName>
<params>
<param>
<value>
<int>client_id</int>
</value>
</param>
<param>
<value>
<string>client_md5</string>
</value>
</param>
<param>
<value>
<struct>
<member>
<name>ID_message</name>
<value>
<i4>123456</i4>
</value>
</member>
<member>
<name>ID_user_list</name>
<value>
<i4>123456</i4>
</value>
</member>
<member>
<name>use_utf</name>
<value>
<string>FALSE</string>
</value>
</member>
<member>
<name>allow_split</name>
<value>
<string>FALSE</string>
</value>
</member>
<member>
<name>source</name>
<value>
<string>Odesilatel</string>
</value>
</member>
</struct>
</value>
</param>
------- komu -------
<param>
<value>
<struct>
<member>
<name>mobile</name>
<value>
<i4>+420778535877</i4>
</value>
</member>
<member>
<name>email</name>
<value>
<string>mail@example.com</string>
</value>
</member>
<member>
<name>first_name</name>
<value>
<string>Jméno</string>
</value>
</member>
<member>
<name>gender</name>
<value>
<string>F</string>
</value>
</member>
<member>
<name>custom1</name>
<value>
<i4>123</i4>
</value>
</member>
<member>
<name>custom2</name>
<value>
<string>vlastní pole</string>
</value>
</member>
</struct>
</value>
</param>
------- co -------
<param>
<value>
<struct>
<member>
<name>sms_data</name>
<value>
<string>obsah sms v base64</string>
</value>
</member>
<member>
<name>content</name>
<value>
<struct>
<member>
<name>VAR1</name>
<value>
<string>data v base64</string>
</value>
</member>
<member>
<name>VAR2</name>
<value>
<string>data v base64</string>
</value>
</member>
<member>
<name>VAR_GROUP</name>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>VAR1a</name>
<value>
<string>data v base64</string>
</value>
</member>
<member>
<name>VAR1b</name>
<value>
<string>data v base64</string>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>VAR2a</name>
<value>
<string>data v base64</string>
</value>
</member>
<member>
<name>VAR2b</name>
<value>
<string>data v base64</string>
</value>
</member>
</struct>
</value>
</data>
</array>
</value>
</member>
</struct>
</value>
</member>
</struct>
</value>
</param>
--------------
</params>
</methodCall>
{
"function": "mailkit.sendsms",
"id": "client_id",
"md5": "client_md5",
"parameters": {
"campaign": {
"ID_message": 12346,
"ID_user_list": 123456,
"use_utf": false,
"allow_split": false,
"source": "SenderName"
},
"recipient": {
"email":"",
"mobile":"+420777744440",
"first_name":"John",
"last_name": "Doe",
"gender": "m",
"custom1": "custom field",
"custom2": "custom field"
},
"content": {
"sms_data": "base64 encoded content",
"content": {
"var1": "base64 encoded data",
"var2": "base64 encoded data",
}
}
}
}
my $result = $server->call(
'mailkit.sendsms',
$cid,
$md5,
{
'ID_user_list' => $ID_user_list,
'ID_message' => $ID_message,
'use_utf' => 'TRUE',
'allow_split' => 'FALSE'
'source' => 'Odesilatel',
},
{
'email' => $email,
'mobile' => $mobile,
'custom1' => 1,
'custom2' => 2,
'custom3' => 3,
},
{
'sms_data' => encode_base64("vlastni obsah sms"),
'content',
{
'company_rpc',encode_base64('Mailkit'),
'name_rpc',encode_base64('nejaky nazev'),
'test_url',encode_base64('http://www.example.cz'),
},
},
);
client_id * = API ID
naleznete ve svém Mailkit účtu v menu Profil / Integrace / Nastavení API.
client_md5 * = MD5 kód
naleznete ve svém Mailkit účtu v menu Profil / Integrace / Nastavení API.
ID_message * = ID SMS kampaně
ID_user_list * = ID seznamu příjemců
use_utf = diakritika v SMS. Může nabývat hodnot:
allow_split = umožnit rozdělení SMS do více částí (max. 6). Může nabývat hodnot:
source = název odesílatele. Nepovinné pole. Tento název se zobrazí příjemci jako odesílatel zprávy. Název musí být předem schválený.
mobile * = mobilní telefonní číslo příjemce v mezinárodním tvaru (+420XXXYYYXXX)
email = e-mailová adresa příjemce. Údaj není povinný - ale v případě jeho nevyplnění bude systémem doplněn příjemci e-mail ve tvaru +420XXXYYYXXX@mailkit.mobile.
Mějte na paměti, že výchozím údajem každého příjemce je vždy pouze jeho e-mailová adresa. Proto, pokud bude poprvé do systému vloženo pouze mobilní číslo příjemce a po druhé bude s mobilním číslem vložen i jeho e-mail - nedojde ke spárování, ale vzniknou 2 odlišní příjemci.
first_name,
gender,
custom1, ... = individuální data příjemce
sms_data (v base64) = obsah SMS zprávy v base64
content (v base64) = proměnný obsah v base64, který bude vložen na definovaná místa obsahu SMS prostřednictvím tagů, např. [VAR1] či [JINY_NAZEV].
* povinný parametr
<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>data</name>
<value>
<i4>12345678</i4>
</value>
</member>
<member>
<name>data2</name>
<value>
<i4>12345</i4>
</value>
</member>
<member>
<name>data3</name>
<value>
<i4>12345678</i4>
</value>
</member>
<member>
<name>status</name>
<value>
<i4>0</i4>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
{
"status": "0",
"data": "123456789",
"data2": "123456",
"error_status": 0,
"sms_data": "",
"data3": "123456789"
}
data = ID nově vloženého nebo nalezeného příjemce
data2 = ID rozesílky
data3 = ID zprávy
status
error_status