Аккаунт и интеграции

Подключение внешней системы или ассистента

Создайте ключ с ограниченными правами на Pro или Agency, публикуйте новый контент или подключите ассистента.

Перед началом

Вебхук получает уведомления о входящих сообщениях от службы WhatsApp. Настройка сервера относится к ответственному за интеграцию. Пользователям панели не нужно изменять сервер. MCP позволяет ассистенту запрашивать инструменты аккаунта.

Что делать

Для входящих сообщений откройте «Настройки» и найдите «URL вебхука».
Выберите «Копировать», чтобы получить точный адрес вашей установки.
Попросите ответственного настроить входящие события нужного устройства с этим адресом.
Организуйте входящее тестовое сообщение со своего номера после подтверждения готовности ответственным.
Проверьте ожидаемый результат, например подходящий автоматический ответ или новую запись сообщения группы при включённом «Журнал».
Для подключения ассистента войдите через экран авторизации, открытый вашим клиентом MCP.
Проверьте название приложения и аккаунт перед разрешением доступа.
Для интеграции исходящих отправок откройте Настройки → Внешние интеграции. Создайте именованный ключ для одного подключённого аккаунта и явно выбранных групп. Сразу сохраните ключ: он показывается только один раз. Скопируйте базовый URL API.
Пример: Настройте Abacus.AI на создание нового контента к каждому из восьми ежедневных времён публикации в America/Sao_Paulo. Отправляйте каждую публикацию в три разрешённые группы с новым Idempotency-Key. Повторно используйте этот ключ только для повтора полностью идентичного запроса.
Не указывайте scheduled_at, чтобы сразу поставить запрос в очередь, или задайте абсолютную временную метку с -03:00 либо Z (UTC), не более чем на 30 дней вперёд. Обработчик проверяет очередь каждую минуту; scheduled_at задаёт самое раннее допустимое время, без гарантии доставки в точную секунду.
Перед повторной попыткой проверьте статус задания и результаты по группам. Отменяйте только ещё не начавшиеся отправки. Отзовите скомпрометированный ключ в Настройках, затем создайте и сохраните замену; старые задания не возобновляются с новым ключом.

Разобранный пример

Запросы с заполнителями: перед отправкой замените идентификаторы и выберите будущую дату. Эти запросы публикуют настоящие сообщения. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

Как проверить результат

Принятие задания и принятые результаты по группам подтверждают приём шлюзом. Они не подтверждают доставку или прочтение. Запланированные задания могут блокироваться при изменении доступа, ключа, аккаунта или разрешений групп.

Что нужно знать

Ассистенты могут читать доступные записи и отправлять текст по запросу. Перед запросом отправки изучите руководство об инструментах ассистента.
Для редактирования, недоступного через MCP, используйте панель.
Доступ к API включён в месячные и годовые планы Pro и Agency. Для Starter нужен переход на другой план. Ключи разрешают только выбранный аккаунт и группы; замена аккаунта WhatsApp блокирует отправку. Никогда не передавайте учётные данные сервера.
Тексты поддерживают 4 096 символов, подписи — 1 024. Загружайте файлы JPEG, PNG или WebP размером до 5 MiB в полях multipart payload и image. URL удалённых изображений не принимаются.
Новое задание возвращает HTTP 202. Идентичный повтор с тем же Idempotency-Key возвращает исходное задание с HTTP 200; другое содержимое с тем же ключом возвращает 409. При истечении времени ожидания после начала отправки результат может остаться неподтверждённым; не отправляйте запрос автоматически с другим ключом.

Частые проблемы

Что вы видите: После теста нет ответа или новой записи.
Что делать: Проверьте соединение устройства и соответствующее правило либо «Журнал», затем попросите ответственного проверить настройку входящих событий.
Чего ожидать: Правильно настроенная функция может обработать новое подходящее событие.

Что вы видите: Ассистент не авторизуется или показывает другой аккаунт.
Что делать: Вернитесь ко входу и выберите нужный аккаунт; сообщите ответственному о повторных ошибках авторизации.
Чего ожидать: Экран авторизации и полученные записи относятся к нужному аккаунту.

Дополнительная помощь

Сообщите ответственному функцию и видимую ошибку. Не включайте серверные учётные данные в разговоры с ассистентом.

Открыть функцию