Перейти к содержанию

CreateInstance#

Метод предназначен для создания инстанса аккаунта мессенджера от имени партнёра.

После создания инстанса без настроек, настройки по умолчанию будут выключены.

Запрос#

Для создания инстанса аккаунта от имени партнёра требуется выполнить POST запрос по адресу:

{{APIUrl}}/partner/createInstance/{{partnerToken}}

Получение параметра запроса partnerToken происходит через техподдержку Green API с запросом получить API-ключ партнёра.

Параметры запроса#

Допускается указывать параметры выборочно. Хотя бы один параметр должен быть указан.

Параметр Тип Обязательный Описание
webhookUrl string необязательный URL для отправки webhook оповещений
webhookUrlToken string необязательный Токен для подключения к вашему вебхук серверу;
delaySendMessagesMilliseconds integer необязательный задержка между отправкой исходящих сообщений в миллисекундах, по умолчанию 3000 мсек, минимум 500 мсек
markIncomingMessagesReaded string необязательный отмечать входящие сообщения прочитанными или нет (“yes”/”no”), по умолчанию “no”, параметр игнорируется, если markIncomingMessagesReadedOnReply в значении “yes”
markIncomingMessagesReadedOnReply string необязательный отмечать входящие сообщения прочитанными или нет (“yes”/”no”) при отправке сообщения в чат, по умолчанию “no” (входящие сообщения не помечаются прочитанными)
outgoingWebhook string необязательный Получать уведомления о статусах отправки/доставки/прочтении исходящих сообщений, возможные значения: “yes”, “no”. По умолчанию “no”
outgoingMessageWebhook string необязательный Получать уведомления о сообщениях, отправленных с телефона, возможные значения: “yes”, “no”. По умолчанию “no”
stateWebhook string необязательный Получать уведомления об изменении состояния авторизации аккаунта, возможные значения: “yes”, “no”. По умолчанию “no”
incomingWebhook string необязательный Получать уведомления о входящих сообщениях и файлах, возможные значения: “yes”, “no”. По умолчанию “no”
deviceWebhook string необязательный Получать уведомления об устройстве (телефоне) и уровне заряда батареи, возможные значения: “yes”, “no”. По умолчанию “no”
outgoingAPIMessageWebhook string необязательный Получать уведомления о сообщениях, отправленных из API, возможные значения: “yes”, “no”. По умолчанию “no”
keepOnlineStatus string необязательный Отображать статус инстанса “В сети”. Возможные значения: “yes”, “no”. По умолчанию “no”. Примечание: При включенной настройке не будут приходить звуковые уведомления о новых сообщениях на телефонный аппарат, подключенный к API
pollMessageWebhook string необязательный Получать уведомления о создании опроса и голосовании в опросе, возможные значения: “yes”, “no”. По умолчанию “no”
incomingBlockWebhook string необязательный Уведомление временно не работает. Получать уведомления о добавлении чата в список заблокированных контактов, возможные значения: “yes”, “no”. По умолчанию “no”
incomingCallWebhook string необязательный Получать уведомления о статусах входящего звонка, возможные значения: yes, no

Пример тела запроса#

{
    "webhookUrl": "https://mysite.com/webhook/green-api/",
    "webhookUrlToken": "f93537eb3e8fed66847b5bd",
    "delaySendMessagesMilliseconds": 1000,
    "markIncomingMessagesReaded": "no",
    "markIncomingMessagesReadedOnReply": "no",
    "outgoingAPIMessageWebhook": "yes",
    "outgoingWebhook": "yes",
    "outgoingMessageWebhook": "yes",
    "incomingWebhook": "yes",
    "deviceWebhook": "no",
    "stateWebhook": "no",
    "keepOnlineStatus": "no",
    "pollMessageWebhook": "no",
    "incomingBlockWebhook": "yes", // Уведомление временно не работает.
    "incomingCallWebhook": "yes"
}

Ответ#

Поля ответа#

Поле Тип Описание
idInstance int идентификатор инстанса аккаунта
apiTokenInstance string токен API инстанса аккаунта
typeInstance string тип мессенджера для инстанса аккаунта

Пример тела ответа#

В случае успеха, в ответ на запрос, отдается JSON строка следующего вида с HTTP статусом 200:

{
    "idInstance": 1101728000,
    "apiTokenInstance": "c1b0474542144e0ead529eb4861ca5f583c346eb00564f64a7",
    "typeInstance": "whatsapp"
}

В случае неудачи, отдается ответ с HTTP статусом 200, в теле ответа отдается JSON строка с кодом и описанием ошибки:

{
    "code": 401,
    "description": "Unauthorized"
}

Ошибки CreateInstance#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки