Подключите любую систему: 1С, свою CRM, Make или Zapier
Poymai отправляет в вашу систему подписанные события — новый клиент, сделка, сообщение, задача — и принимает обратно изменения этапов и ответственных. Те же автоматизации, что у amoCRM и Битрикс24, без готового коннектора.
HTTPS · HMAC-SHA256 · повторы с идемпотентностью
- 16
- событий в протоколе
- HMAC
- подпись в обе стороны
- 8
- повторов при сбое
Нужно 20 комплектов к пятнице.
Уточните город доставки?
Казань.
Передаю менеджеру, он пришлёт счёт.
Своя CRMновая- Событие
- deal.create
- Подпись
- sha256 ✓
- Ответ
- 201 · 84 мс
Два адреса — и вся интеграция работает
Ваш приёмник событий и адрес webhook Poymai для обратных изменений.
Подписанные события
Poymai отправляет POST JSON на ваш адрес: ping, contact.upsert, deal.create, deal.update, message.created, note.created, task.created, fields.updated. Ответьте 2xx — и, по желанию, id созданной записи.
- Заголовок X-PoymAI-Signature: HMAC-SHA256
- X-PoymAI-Delivery — ключ идемпотентности
- Повторы с нарастающей паузой при 5xx и таймауте
- Необязательные deal.get, deal.search, pipelines.list, users.list
Подходит: 1С, самописным CRM и учётным системам.
Изменения обратно
Отправляйте на адрес webhook Poymai deal.updated, deal.deleted и comment.added. Этап, ответственный и комментарии сразу видны в чате и запускают правила.
- Секретный адрес + необязательная подпись тем же секретом
- Повторы с тем же event_id не дублируются
- Этапы — из pipelines.list или списка в настройках
- Правила «этап → действие с чатом» как у amoCRM
Подходит: Make, Zapier, n8n и serverless-функциям.
Всё, что умеют готовые коннекторы, для вашей системы
Автоматизации, ИИ и карточка сделки в чате работают одинаково для любой CRM.
Сделка из чата
По правилу: с первым сообщением, когда известен телефон, когда ИИ видит намерение купить, или вручную оператором.
Сообщения в сделку
Вся переписка, только первое сообщение и итог ИИ или только заметки — как вам удобнее.
Этапы и правила
Состояние чата двигает сделку, этап сделки закрывает чат, просит оценку или передаёт оператору.
Свои поля
Канал, username, город, ссылка на чат и данные, которые понял ИИ, — событием fields.updated.
Задачи
Клиент ждёт ответа дольше нормы — событие task.created ответственному.
Подпись HMAC
Каждое событие подписано; секрет можно перевыпустить в один клик.
Безопасность
Только HTTPS, приватные и служебные адреса запрещены, ping проверяет приёмник до сохранения.
Надёжная доставка
Очередь с повторами и журнал: видно каждое событие, ошибку и кнопку «Повторить».
Готовый пример
Эталонный приёмник на 150 строк Python — скопируйте и подключите свою логику.
Сообщение клиента — событие в вашей системе
Poymai берёт на себя каналы, ИИ и очередь доставки; ваша система — данные.
- ШАГ 1
Клиент пишет
В любой подключённый канал.
- ШАГ 2
ИИ и правила
Отвечают и решают, когда создать сделку.
- ШАГ 3
Подписанное событие
deal.create, message.created и другие — в вашу систему.
- ШАГ 4
Изменения обратно
deal.updated двигает чат по вашим правилам.
Ваш процесс — без переписывания CRM
Несколько типовых связок, которые собираются за вечер.
Пришлите счёт на 20 комплектов.
Счёт № 1042 выставлен, отправили на почту.
Оплатили, спасибо!
Не пишите интеграцию с каждым мессенджером
Poymai уже подключён к Telegram, WhatsApp, MAX, ВКонтакте, почте и сайту.
Запустите приёмник и вставьте адрес
Описание протокола и пример приёмника — scripts/custom_crm_example.py в поставке Poymai.
- 1
Поднимите приёмник
HTTPS-адрес, который принимает POST JSON и проверяет X-PoymAI-Signature.
- 2
Подключите в Poymai
Настройки → Интеграции → Своя CRM. Poymai отправит подписанный ping.
- 3
Сохраните секрет
Секрет подписи и адрес webhook показываются один раз; их можно перевыпустить.
- 4
Настройте этапы
Список этапов и правила «чат ↔ этап» — на странице CRM → Настройки.
Ответ не 2xx повторяется с нарастающей паузой до 8 раз, затем событие видно в журнале с кнопкой «Повторить». Используйте X-PoymAI-Delivery, чтобы повтор не создал дубль.
Первые 14 дней тарифа «Бизнес» — бесплатно и без привязки карты. Тарифы — за компанию, а не за каждого сотрудника, скидка 10% за квартал и 20% за год.
Есть популярная CRM? Подключите в один клик
Для этих систем Poymai уже умеет всё сам — протокол не нужен.
Статьи и сравнения
Инструкции из блога и сравнение Poymai с другими сервисами.
Своя CRM: протокол, безопасность и надёжность
Как проверить подпись?
Вычислите HMAC-SHA256 от строки «X-PoymAI-Timestamp.тело запроса» вашим секретом и сравните с заголовком X-PoymAI-Signature (формат sha256=…). Отклоняйте запросы старше 5 минут.
Что ответить на deal.create?
Любой 2xx. Если вернёте JSON {"id": "…"}, Poymai запомнит id вашей сделки; иначе использует свой (poymai-<id диалога>). Можно вернуть и url карточки и stage_id.
Как прислать изменения в Poymai?
POST на адрес webhook из настроек: deal.updated (id, stage_id, ответственный), deal.deleted или comment.added. Укажите event_id — повтор с тем же id не задублируется.
Подойдут Make, Zapier или n8n?
Да: модуль «Webhook» принимает события Poymai, а HTTP-модуль отправляет изменения обратно. Подпись в обратную сторону необязательна — достаточно секретного адреса.
Что, если моя система не умеет отдавать сделку?
deal.get и deal.search необязательны. Без них карточка в чате строится по данным, которые вы присылаете в deal.updated, а привязать сделку можно по точному id.
Можно ли адрес в локальной сети?
Нет: из соображений безопасности Poymai отправляет события только на публичные HTTPS-адреса. Для 1С в закрытом контуре используйте шлюз или публикацию веб-сервиса.
Подключите свою систему к мессенджерам и ИИ
Один протокол — и сделки из Telegram, WhatsApp, MAX, ВКонтакте, почты и сайта появляются у вас.
+7 977 702-63-54- Подпись HMAC-SHA256
- Повторы и журнал
- Те же правила, что у amoCRM
- Пример приёмника