{
    "componentChunkName": "component---src-templates-doc-page-js",
    "path": "/docs/ru/telephony/calls_api/add_phones/",
    "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"627eb747-064e-51df-8fab-647d72b2a743","excerpt":"Добавление номеров в рассылку Следующие методы Calls API служат для добавления в рассылку номеров с параметрами:   GET /addPhone Метод  — упрощенный метод для…","html":"<h1>Добавление номеров в рассылку</h1>\n<hr>\n<p>Следующие методы <a href=\"/1.10.5/docs/ru/telephony/calls_api/calls_api\">Calls API</a> служат для добавления в рассылку номеров с параметрами:</p>\n<ul>\n<li><code class=\"language-text\">GET {host_name}/api/calls/campaign/{token}/addPhone</code></li>\n<li><code class=\"language-text\">POST {host_name}/api/calls/campaign/{token}/addPhones</code></li>\n</ul>\n</br>\n<h2>GET /addPhone</h2>\n<p>Метод <code class=\"language-text\">GET /addPhone</code> — упрощенный метод для добавления единичного номера в рассылку. Настройки задания на обзвон передаются в параметрах строки запроса:</p>\n<ul>\n<li><code class=\"language-text\">phone</code> — номер телефона абонента, обязательный параметр.</li>\n<li><code class=\"language-text\">gmtZone</code> — часовой пояс абонента, необязательный параметр.</li>\n</ul>\n<blockquote>\n<p><code class=\"language-text\">gmtZone</code> должен удовлетворять одному из следующих форматов:</p>\n<ul>\n<li><code class=\"language-text\">Z</code> — время UTC.</li>\n<li><code class=\"language-text\">+h</code>, <code class=\"language-text\">+hh</code>, <code class=\"language-text\">±hhmm</code> или <code class=\"language-text\">±hhmmss</code> с опциональными элементами:\n<ul>\n<li>разделитель <code class=\"language-text\">:</code> между часами, минутами и секундами, например <code class=\"language-text\">+hh:mm:ss</code>;</li>\n<li>префикс <code class=\"language-text\">UTC</code>, <code class=\"language-text\">GMT</code> или <code class=\"language-text\">UT</code>, например <code class=\"language-text\">GMT-hh:mm</code>.</li>\n</ul>\n</li>\n<li>ID часовых поясов, установленных <a href=\"https://docs.oracle.com/middleware/12212/wcs/tag-ref/MISC/TimeZones.html\" target=\"_blank\" rel=\"noopener noreferrer\">IANA TZDB</a>.</li>\n</ul>\n</blockquote>\n<p class='warn'>В запросе также можно передавать любые дополнительные параметры. Все переданные параметры доступны из сценария через метод <a href=/1.10.5/docs/ru/telephony/script_voice_bot#Работа-со-списком-номеров  ><code class=\"language-text\">$dialer.getPayload</code></a>.</p>\n</br>\n<p>Рассмотрим пример запроса на добавление задания на обзвон со следующими параметрами:</p>\n<ul>\n<li>Номер абонента — <code class=\"language-text\">79110000000</code>.</li>\n<li>Часовой пояс — московское время.</li>\n<li>Имя абонента — <code class=\"language-text\">Alex</code>.</li>\n</ul>\n<div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">curl</span> <span class=\"token string\">'https://app.jaicp.com/api/calls/campaign/8231.7056.1b131df1/addPhone?phone=79110000000&amp;gmtZone=+03:00&amp;name=Alex'</span></code></pre></div>\n<p>Ответом на такой запрос будет идентификатор созданного задания на обзвон в строковом формате.</p>\n</br>\n<h2>POST /addPhones</h2>\n<p>Метод <code class=\"language-text\">POST /addPhones</code> не ограничивает число номеров, которые можно передать в одном запросе, и поддерживает ряд дополнительных параметров настройки <a href=\"#%D0%9E%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BE%D0%BB%D0%B8%D1%82%D0%B8%D0%BA%D0%B8-%D0%B7%D0%B2%D0%BE%D0%BD%D0%BA%D0%B0\">политики звонка</a> для каждого номера.</p>\n<p class='warn'>Использовать этот метод также более предпочтительно, если дополнительных параметров слишком много или они содержат длинные строки.</p>\n<p>Следующий запрос эквивалентен предыдущему:</p>\n<div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">curl</span> --request POST <span class=\"token string\">'https://app.jaicp.com/api/calls/campaign/8231.7056.1b131df1/addPhones'</span> <span class=\"token punctuation\">\\</span>\n--header <span class=\"token string\">'Content-Type: application/json'</span> <span class=\"token punctuation\">\\</span>\n--data-raw <span class=\"token string\">'[\n    {\n        \"phone\": 79110000000,\n        \"gmtZone\": \"+03:00\",\n        \"payload\": {\n            \"name\": \"Alex\"\n        }\n    }\n]'</span></code></pre></div>\n<p>Ответ на запрос — массив идентификаторов всех созданных заданий на обзвон.</p>\n</br>\n<h3>Определение политики звонка</h3>\n<p>При добавлении номера в рассылку при помощи API вы можете также задать индивидуальные настройки для звонка. Для этого при вызове метода <a href=\"https://help.just-ai.com/docs/api/calls_api/#/PublicCallsApi/addPhones\" target=\"_blank\" rel=\"noopener noreferrer\"><code class=\"language-text\">POST /addPhones</code></a> в теле запроса передайте параметры, указанные в схеме <code class=\"language-text\">CallJobParameters</code>.</p>\n<p>Если параметры не были переданы, номер добавляется в очередь, и звонки идут в общем порядке. При добавлении номера с параметрами индивидуальной политики его приоритет относительно других номеров повышается согласно политике звонков.</p>\n<p class='warn'><a href=/1.10.5/docs/ru/telephony/call_policy  >Подробнее о политике звонков</a></p>","frontmatter":{"title":"","description":null},"headings":[{"value":"Добавление номеров в рассылку"}]}},"pageContext":{"slug":"/docs/ru/telephony/calls_api/add_phones/","previous":{"fields":{"slug":"/docs/ru/telephony/calls_api/campaign_control/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/telephony/calls_api/calls_api/"},"frontmatter":{"title":"","description":null}}}},
    "staticQueryHashes": ["1209419333"]}