Îòïðàâêà ñîîáùåíèé

Îòïðàâêà SMS-ñîîáùåíèÿ

Âñå ïàðàìåòðû, êîòîðûå ñîäåðæàò ñïåöèàëüíûå ñèìâîëû (ïëþñ, ïðîáåë è ò.ä.), äîëæíû áûòü çàêîäèðîâàíû ïðè ïîìîùè ôóíêöèè urlencode äëÿ ïåðåäà÷è â HTTP-çàïðîñå.

Îòïðàâêà ñîîáùåíèé. Îòâåò ñåðâåðà è êîäû îøèáîê

• ERROR = N (îïèñàíèå) – äëÿ îøèáîê 1,2,4,5,9;
  
  
• ERROR = N (îïèñàíèå), ID - <id ñîîáùåíèÿ> – äëÿ îøèáîê 3,6,7,8.

• 0,-N – äëÿ îøèáîê 1,2,4,5,9;
• <id ñîîáùåíèÿ>,-N – äëÿ îøèáîê 3,6,7,8.

• Äëÿ îøèáîê 1,2,4,5,9:
  
  

  <result> <error>îïèñàíèå</error> <error_code>N</error_code> </result>

  
  
• Äëÿ îøèáîê 3,6,7,8:

  <result> <error>îïèñàíèå</error> <error_code>N</error_code> <id>id ñîîáùåíèÿ</id> </result>

• Äëÿ îøèáîê 1,2,4,5,9:

  { "error": "îïèñàíèå", "error_code": N }

  
  
• Äëÿ îøèáîê 3,6,7,8:

  { "error": "îïèñàíèå", "error_code": N, "id": <id ñîîáùåíèÿ> }

• ïðè cost = 0 è fmt = 0: OK - <n> SMS, ID - <id>
  
  
• ïðè cost = 1 è fmt = 0: <cost> (<n> SMS)
  
  
• ïðè cost = 2 è fmt = 0: OK - <n> SMS, ID - <id>, COST - <cost>
  
  
• ïðè cost = 3 è fmt = 0: OK - <n> SMS, ID - <id>, COST - <cost>, BALANCE - <balance>
  
  
• ïðè cost = 0 è fmt = 1: <id>,<n>
  
  
• ïðè cost = 1 è fmt = 1: <cost>,<n>
  
  
• ïðè cost = 2 è fmt = 1: <id>,<n>,<cost>
  
  
• ïðè cost = 3 è fmt = 1: <id>,<n>,<cost>,<balance>
  
  
• ïðè cost = 0 è fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> </result>

  
  
• ïðè cost = 1 è fmt = 2:

  <result> <cost>cost</cost> <cnt>n</cnt> </result>

  
  
• ïðè cost = 2 è fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> <cost>cost</cost> </result>

  
  
• ïðè cost = 3 è fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> <cost>cost</cost> <balance>balance</balance> </result>

  
  
• ïðè cost = 0 è fmt = 3:

  { "id": <id>, "cnt": <n> }

  
  
• ïðè cost = 1 è fmt = 3:

  { "cost": "<cost>", "cnt": <n> }

  
  
• ïðè cost = 2 è fmt = 3:

  { "id": <id>, "cnt": <n>, "cost": "<cost>" }

  
  
• ïðè cost = 3 è fmt = 3:

  { "id": <id>, "cnt": <n>, "cost": "<cost>", "balance": "<balance>" }

  
  
• ïðè op = 1 è fmt = 0 èëè 1, èíôîðìàöèÿ äîáàâëÿåòñÿ â êîíåö îáû÷íîãî âûâîäà ñ íîâîé ñòðîêè:
  <phone>,<mccmnc>,<cost>,<status>,<error>
  
  
• ïðè op = 1 è fmt = 2, â îòâåò äîáàâëÿåòñÿ ìàññèâ:

  <phones> <phone mccmnc="mccmnc" cost="cost" status="status" error="error">phone</phone> ... </phones>

  
  
• ïðè op = 1 è fmt = 3, â îòâåò äîáàâëÿåòñÿ ìàññèâ:

  "phones": [{ "phone": "<phone>", "mccmnc": "<mccmnc>", "cost": "<cost>", "status": "<status>", "error": "<error>" }, ... ]

  
  

Ñåðâåð íå ïðèíèìàåò áîëåå îäíîãî îäèíàêîâîãî çàïðîñà íà îòïðàâêó SMS-ñîîáùåíèé â òå÷åíèå ìèíóòû äëÿ çàùèòû îò îøèáîê è çàöèêëèâàíèé â ïðîãðàììå íà ñòîðîíå Êëèåíòà äëÿ òîãî, ÷òîáû ñíèçèòü íàãðóçêó è íå ðàñõîäîâàòü ñðåäñòâà Êëèåíòà, à òàêæå íå äîïóñòèòü ìíîãîêðàòíîé îòïðàâêè ñîîáùåíèÿ îäíîìó àáîíåíòó.

Ñåðâåð òàêæå áëîêèðóåò îòïðàâêó áîëåå 50 ñîîáùåíèé îäíîìó àáîíåíòó, êîòîðûå áûëè îòïðàâëåíû ñ ïåðåðûâîì ìåæäó ñîîáùåíèÿìè ìåíåå 60-òè ñåêóíä, äëÿ çàùèòû îò ôëóäà è ëèøíåãî ñïèñàíèÿ ñðåäñòâ ñî ñ÷åòà Êëèåíòà, òàê êàê ìíîãèå îïåðàòîðû íå ïðîïóñêàþò áîëüøîå êîëè÷åñòâî ñîîáùåíèé îäíîìó àáîíåíòó çà êîðîòêèé ïðîìåæóòîê âðåìåíè.

Ïðèìåðû îòïðàâêè ñîîáùåíèé

Êîììåíòàðèè â SMS-ñîîáùåíèÿõ

Îòïðàâêà íà ãðóïïó íîìåðîâ

Îòïðàâêà HLR-çàïðîñà

Îòïðàâêà e-mail ñîîáùåíèÿ

Ïðèìåðû îòïðàâêè e-mail ñîîáùåíèé

Îòïðàâêà ãîëîñîâîãî ñîîáùåíèÿ (çâîíîê)

• voice = m – ìóæñêîé ãîëîñ.
• voice = m2 – ìóæñêîé ãîëîñ 2.
• voice = m3 – ìóæñêîé ãîëîñ 3 (ïî óìîë÷àíèþ).
• voice = m4 – ìóæñêîé ãîëîñ 4.
• voice = w – æåíñêèé ãîëîñ.
• voice = w2 – æåíñêèé ãîëîñ 2.
• voice = w3 – æåíñêèé ãîëîñ 3.
• voice = w4 – æåíñêèé ãîëîñ 4.

Èñïîëüçîâàíèå ãîëîñîâîãî ìåíþ (IVR)

Ïðèìåðû îòïðàâêè ãîëîñîâûõ ñîîáùåíèé

Îòïðàâêà viber-ñîîáùåíèÿ

Ïåðåäà÷à ôàéëîâ

• â âèäå ïîëíîãî http(s)-àäðåñà âíåøíåãî ôàéëà, óêàçàííîãî â òåêñòå ñîîáùåíèÿ, â ôîðìàòå <file http(s)://...> (òîëüêî äëÿ êàðòèíîê è ôàéëîâ äîêóìåíòîâ);
• ìåòîäîì POST â òåëå http(s)-çàïðîñà ê ñåðâåðó. Ïðè äàííîì ñïîñîáå îòïðàâêè ïðèêðåïëÿåìûå ôàéëû íåîáõîäèìî îáîçíà÷èòü â òåêñòå ñîîáùåíèÿ ñïåöèàëüíûì îáðàçîì â âèäå "<file n>", ãäå n - íîìåð ôàéëà â ôîðìèðóåìîì ñïèñêå íà÷èíàÿ ñ åäèíèöû;
• äîáàâëåíèåì â http(s)-çàïðîñ ñïåöèàëüíîãî äîïîëíèòåëüíîãî ïàðàìåòðà fileurl, ñîäåðæàùåãî ïîëíûé http(s)-àäðåñ ïåðåäàâàåìîãî âíåøíåãî ôàéëà. Ïðè èñïîëüçîâàíèè fileurl ïåðåäà÷à â çàïðîñå ïàðàìåòðà mes íåîáÿçàòåëüíà;
• ïðè îòïðàâêå ñ ëè÷íîãî êàáèíåòà èëè ÷åðåç API âñòàâêîé â òåêñò ñîîáùåíèÿ ïîëíîé http(s)-ññûëêè ðàíåå çàãðóæåííîãî ôàéëà, óçíàòü êîòîðóþ ìîæíî â ëè÷íîì êàáèíåòå íà ñòðàíèöå îòïðàâêè, íàæàâ ïîñëåäîâàòåëüíî "ïðèêðåïèòü ôàéë" – "Çàãðóæåííûå ôàéëû".

• jpg, jpeg, gif, png – äëÿ êàðòèíîê;
• doc, docx, rtf, dotx, dot, odf, fodt, odt, txt, info, pdf, xps, eps, pdax, xlsx, xlsm, fods, ods, csv, xltx – äëÿ ôàéëîâ äîêóìåíòîâ;
• 3gp, m4v, mov, mp4 – äëÿ âèäåî.

Äîáàâëåíèå êíîïêè

Òèïû ñîîáùåíèé

• Òîëüêî òåêñò – àáîíåíò ïîëó÷àåò òåêñòîâîå ñîîáùåíèå.
• Òîëüêî êàðòèíêà – àáîíåíò ïîëó÷àåò êàðòèíêó.
• Òåêñò+êíîïêà – àáîíåíò ïîëó÷àåò òåêñòîâîå ñîîáùåíèå, ïîä êîòîðûì ðàñïîëîæåíà êíîïêà. Ïðè íàæàòèè íà êíîïêó ïðîèñõîäèò ïåðåõîä ïî çàäàííîé ññûëêå.
• Òåêñò+êíîïêà+êàðòèíêà – àáîíåíò ïîëó÷àåò òåêñòîâîå ñîîáùåíèå, ïîä êîòîðûì ðàñïîëîæåíû êàðòèíêà è êíîïêà. Ïðè íàæàòèè íà êíîïêó ïðîèñõîäèò ïåðåõîä ïî çàäàííîé ññûëêå.
• Òîëüêî ôàéë – àáîíåíòó ïåðåäàåòñÿ ôàéë îäíîãî èç ïîääåðæèâàåìûõ ôîðìàòîâ.
• Êàðòèíêà+âèäåî – àáîíåíò ïîëó÷àåò âèäåî-ôàéë, çàñòàâêîé ê êîòîðîìó ÿâëÿåòñÿ ïåðåäàâàåìàÿ êàðòèíêà.
• Òåêñò+êàðòèíêà+âèäåî – àáîíåíò ïîëó÷àåò âèäåî-ôàéë ñ êàðòèíêîé-çàñòàâêîé è óêàçàííûì òåêñòîì.
• Òåêñò+êàðòèíêà+âèäåî+êíîïêà – àáîíåíò ïîëó÷àåò âèäåî-ôàéë ñ êàðòèíêîé-çàñòàâêîé, óêàçàííûì òåêñòîì è êíîïêîé. Ïðè íàæàòèè íà êíîïêó ïðîèñõîäèò ïåðåõîä ïî çàäàííîé ññûëêå.

• Hello! This is test message
• Çäðàâñòâóéòå! Ýòî òåñòîâîå ñîîáùåíèå
• Test
• Òåñò
• Test {button,https://m.smsc.ru,site}
• Òåñò {button,https://m.smsc.ru,ñàéò}
• Picture <file http://m.smsc.ru/im/smsc_logo_tiny.gif>
• Êàðòèíêà <file http://m.smsc.ru/im/smsc_logo_tiny.gif>

Ïðèìåðû îòïðàâêè viber-ñîîáùåíèé

Îòïðàâêà ñîîáùåíèÿ â Telegram

Ïðèìåðû îòïðàâêè ñîîáùåíèé â Telegram

Îòïðàâêà ñîîáùåíèÿ â ÷àò-áîò Telegram

Ïðèìåðû îòïðàâêè ñîîáùåíèé â ÷àò-áîò Telegram

Èñïîëüçîâàíèå ïðåôèêñîâ ïðè îòïðàâêå ñîîáùåíèé

Óïðàâëåíèå øàáëîíàìè ñîîáùåíèé

• ïðè fmt = 0:
  ERROR = N (îïèñàíèå)
  
  
• ïðè fmt = 1:
  0,-N
  
  
• ïðè fmt = 2:

  <result> <error>îïèñàíèå</error> <error_code>N</error_code> </result>

  
  
• ïðè fmt = 3:

  { "error": "îïèñàíèå", "error_code": N }

• ïðè fmt = 0: ID - <id>
  
  
• ïðè fmt = 1: <id>
  
  
• ïðè fmt = 2:

  <template> <id>id</id> </template>

  
  
• ïðè fmt = 3:

  { "id": <id> }

• ïðè fmt = 0, 1: OK
  
  
• ïðè fmt = 2:
  <result>OK</result>
  
  
• ïðè fmt = 3:
  

  { "result": "OK" }

  
  
  

• ïðè fmt = 0:

  id = <id>, name = <name>, format = <format>, sender = <sender>, flag = <flag>, message = <message> ...

  
  
• ïðè fmt = 1:

  <id>,<name>,<format>,<sender>,<flag>,<message> ...

  
  
• ïðè fmt = 2:

  <list> <template> <id>id</id> <name>name</name> <format>format</format> <sender>sender</sender> <flag>flag</flag> <message>message</message> </template> ... </list>

  
  
• ïðè fmt = 3:

  [{ "id": <id>, "name": "<name>", "format": "<format>", "sender": "<sender>", "flag": <flag>, "message": "<message>" }, ...]

  
  

Ñåðâåð íå ïðèíèìàåò áîëåå òðåõ îäèíàêîâûõ çàïðîñîâ íà äåéñòâèÿ ñ øàáëîíàìè â òå÷åíèå ìèíóòû äëÿ ñíèæåíèÿ íàãðóçêè è çàùèòû îò îøèáîê è çàöèêëèâàíèé â ïðîãðàììå íà ñòîðîíå Êëèåíòà.

Óïðàâëåíèå øàáëîíàìè îïåðàòîðîâ

• ïðè fmt = 0:
  ERROR = N (îïèñàíèå)
  
  
• ïðè fmt = 1:
  0,-N
  
  
• ïðè fmt = 2:

  <result> <error>îïèñàíèå</error> <error_code>N</error_code> </result>

  
  
• ïðè fmt = 3:

  { "error": "îïèñàíèå", "error_code": N }

• ïðè fmt = 0:

  name = <status>, id = <id> ...

  
  
• ïðè fmt = 1:

  <name>,<status>,<id> ...

  
  
• ïðè fmt = 2:

  <result> <template> <name>name</name> <status>status</status> <id>id</id> </template> ... </result>

  
  
• ïðè fmt = 3:

  [{ "name": <status>, "id": <id> }, ...]

• ïðè fmt = 0:

  name = <status>, id = <id> ...

  
  
• ïðè fmt = 1:

  <name>,<status>,<id> ...

  
  
• ïðè fmt = 2:

  <result> <template> <name>name</name> <status>status</status> <id>id</id> </template> ... </result>

  
  
• ïðè fmt = 3:

  [{ "name": <status>, "id": <id> }, ...]

  
  

Ñåðâåð íå ïðèíèìàåò áîëåå äåñÿòè îäèíàêîâûõ çàïðîñîâ íà äåéñòâèÿ ñ øàáëîíàìè â òå÷åíèå ìèíóòû äëÿ ñíèæåíèÿ íàãðóçêè è çàùèòû îò îøèáîê è çàöèêëèâàíèé â ïðîãðàììå íà ñòîðîíå Êëèåíòà.

Âèðòóàëüíàÿ îòïðàâêà (ðåæèì òåñòèðîâàíèÿ)

Óâåäîìëåíèÿ î ñîáûòèÿõ

• ERROR = N (îïèñàíèå)
  
  
• Ïðè fmt = 1:
  0,-N
  
  
• Ïðè fmt = 2:

  <result> <error>îïèñàíèå</error> <error_code>N</error_code> </result>

  
  
• Ïðè fmt = 3:

  { "error": "îïèñàíèå", "error_code": N }

• ïðè fmt = 0 è fmt = 1: OK
  
  
• ïðè fmt = 2:

  <result>OK</result>

  
  
• ïðè fmt = 3:

  { "result": "OK" }

  
  

Ñåðâåð íå ïðèíèìàåò áîëåå ïÿòè îäèíàêîâûõ çàïðîñîâ íà îòïðàâêó óâåäîìëåíèÿ â òå÷åíèå ìèíóòû äëÿ ñíèæåíèÿ íàãðóçêè è çàùèòû îò îøèáîê è çàöèêëèâàíèé â ïðîãðàììå íà ñòîðîíå Êëèåíòà.