Справочник по API

API устройств Sender ID API Уведомление Telegram Вебхуки статуса "Доставка" Webhooks для входящих SMS

SDK и другие библиотеки

PHP SDK Postman NPM SDK Пример PHP Curl Пример PHP Guzzle

Плагины

Send via Excel file AmoCRM Github Repositories 👨‍💻 Обучающие материалы Youtube 📺 Запросить плагин ✉️

Вебхуки

Здесь вы найдете ответы на вопросы как использовать наши вебхуки

Веб-хуки необходимы для более оперативного получения информации. У нас есть два типа вебхуков:

1. Вебхук для получения статуса доставки каждого SMS.

2. Вебхук для приема входящих SMS.

Теперь давайте обсудим каждый из них:

1. Начиная с вебхука, который может уведомить ваш сервер о статусе доставки SMS. Благодаря этому, вам не нужно делать дополнительных API-запросов для отслеживания состояния SMS.

   Чтобы настроить его, перейдите в настройки устройства, и в этом разделе введите следующее поле:
   Вебхуки для статусов доставки SMS

   

   {
     "sms_id": int,
     "status_id": int,
     "status_message": string,
     "sendto": string,
     "senttime": datetime,
     "sim": int (0 or 1),
     "device_id": int
   }
   

   Все здесь простое и понятное. Возможно, только status_id нуждается в уточнении.

   • 1 - Ожидание СМС
   • 2 - SMS, принятые по телефону
   • 3 - В очереди для отправки. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2."
   • 5 - Входящее SMS
   • 6 - Отправленное SMS по телефону
   • 7 - SMS доставлено
   • 8 - SMS не было доставлено
   • 9 - SMS не отправлено вовсе - обобщенный сбой. (Читайте что делать с этой ошибкой здесь)
   • Другое, меньше распространенных ошибок:
   • 10 - SMS не отправлено - No Service
   • 11 - SMS не отправлено - Null PDU
   • 12 - SMS не отправлено - Radio Off
   • 100, 101 - SMS не отправлено - NOT ALLOWED. (Разрешения для отправки SMS в приложении не были предоставлены)

Теперь давайте переключимся в webhook для входящих SMS. Его цель - позволить вам немедленно отправить входящее SMS в вашу систему. Это сделано очень просто: просто укажите вашу конечную точку для этого вебхука в поле 'Webhooks для входящих SMS'. В этом случае вы сможете получать JSON по запросу POST в следующем формате:

{
"address": int,
"date": datetime,
"date_sent": datetime,
"body": string,
"internal_id": int,
"sim": int,
"sms_id": int,  
"device_id": int,
"device_name": devicename
}