googlarz/signal-mcp

Привязывает новое вторичное устройство к вашему аккаунту Signal с помощью device-link URI. URI генерируется на новом устройстве запуском 'signal-cli link' или сканированием QR-кода в Signal Desktop: Настройки → Связанные устройства → Привязать новое устройство. После привязки новое устройство получает будущие сообщения, но не предыдущие. Используйте list_devices, чтобы убедиться, что устройство привязано успешно. Используйте remove_device, чтобы отвязать устройство, которым вы больше не пользуетесь. НЕ делитесь device-link URI: он предоставляет полный доступ к аккаунту Signal тому, кто его использует.

Устанавливает набор стикеров Signal из URL signal.art. После установки необходимо использовать list_sticker_packs для просмотра содержимого набора, затем send_sticker или send_group_sticker для отправки отдельных стикеров. URI должен быть URL signal.art в формате: https://signal.art/addstickers/#pack_id=...&pack_key=...

Удаляет любое сообщение, опубликованное в группе, которую вы администрируете, независимо от отправителя. Сообщение удаляется для всех участников мгновенно. Работает только если вы администратор указанной группы. Используйте list_groups для подтверждения статуса администратора. Для удаления собственных сообщений используйте delete_message (DM) или delete_group_message (group) вместо.

Блокирует контакт Signal, чтобы он больше не мог отправлять вам сообщения или звонить. Блокировка применяется локально через signal-cli и распространяется на сеть Signal. Заблокированный контакт НЕ получает уведомлений — с его стороны сообщения выглядят как отправленные, но они молча отбрасываются до того, как дойдут до вас; уведомления о доставке подавляются. Блокировка не удаляет историю сообщений; предыдущие беседы остаются в вашем локальном хранилище. Блокировка сохраняется после перезапуска и обратима — вызовите unblock_contact, чтобы снять её. Используйте, когда хотите навсегда прекратить получать сообщения от контакта. Используйте unblock_contact для отмены блокировки. НЕ ИСПОЛЬЗУЙТЕ как временное отключение звука — блокировка полностью скрывает контакт из обычного потока сообщений. НЕ ИСПОЛЬЗУЙТЕ для удаления контакта из списка — для этого используйте remove_contact.

Удаляет ВСЕ локально сохранённые сообщения из базы данных signal-mcp. Это НЕ удаляет сообщения из Signal - только из локального хранилища. Требует confirm=true.

Создаёт новую группу Signal с указанными участниками. Вы автоматически добавляетесь как администратор группы. Все перечисленные участники получают уведомление о приглашении. Возвращает ID новой группы и ссылку-приглашение. Для изменения группы после создания (название, описание, участники, настройки ссылки) используйте update_group. Для отправки сообщений в группу используйте send_group_message.

Создайте опрос и отправьте его контакту или группе Signal. Укажите как минимум 2 варианта. Установите multi_select=true, чтобы разрешить голосующим выбирать несколько ответов. Укажите либо recipient (DM), либо group_id (группа) — требуется ровно один. Возвращает временную метку опроса, необходимую для vote_poll и terminate_poll. Используйте terminate_poll, чтобы закрыть опрос и прекратить приём голосов.

Удаляет удалённо (отменяет отправку) сообщение, которое вы ранее отправили в группу Signal. Доставляет запрос на удаление на устройства всех участников группы; сообщение исчезает из их просмотра переписки в клиентах Signal 5.0 и новее. Вы можете удалять только те сообщения, которые отправили сами. Для административного удаления сообщения любого участника используйте admin_delete_message. target_timestamp — это метка времени sent_at сообщения (из get_conversation). На старых клиентах Signal удаление может бесшумно завершиться неудачей. Удалённое удаление не удаляет сообщение из локального хранилища signal-mcp. Используйте, когда хотите отозвать отправленное в группе сообщение. НЕ используйте для личных сообщений. Вместо этого используйте delete_message.

Удаляет локально сохранённые сообщения для одного контакта или группы. НЕ отменяет отправку в Signal — только удаляет из локального хранилища.

Удаляет удалённо (отменяет отправку) сообщение, которое вы ранее отправили контакту Signal. Доставляет запрос на удаление на устройство получателя; сообщение исчезает из его окна переписки в клиентах Signal 5.0 и новее. Вы можете удалять только сообщения, отправленные вами. Вы не можете удалять сообщения, полученные от других. target_timestamp — это временная метка sent_at сообщения (из get_conversation). Удаление может завершиться без ошибки, но не выполниться, если получатель использует старую версию клиента Signal. Удалённое удаление не убирает сообщение из локального хранилища signal-mcp — используйте delete_local_messages, чтобы удалить его локально. Используйте, когда хотите отозвать отправленное сообщение с устройства получателя. НЕ ИСПОЛЬЗУЙТЕ для групповых сообщений — используйте delete_group_message. НЕ ИСПОЛЬЗУЙТЕ для удаления сообщения, которое вы получили — только отправители могут удалять удалённо.

Редактирует текст ранее отправленного сообщения. Отправляет правку через signal-cli всем исходным получателям; они видят обновлённый текст на месте с пометкой '(edited)'. Можно менять только текст сообщения — вложения, цитируемые ответы и реакции неизменны. Правка должна ссылаться на точную временную метку исходного сообщения, которую вернул send_message или get_conversation. Редактировать можно только свои сообщения; попытка отредактировать чужое сообщение возвращает ошибку. Ограничения по времени нет, но клиенты Signal могут игнорировать правки в очень старых сообщениях. Укажите получателя для правки в личном сообщении или group_id для правки в группе; требуется ровно одно значение. Используйте, чтобы исправить опечатку или обновить информацию в уже отправленном сообщении. НЕ используйте, чтобы изменить получателя сообщения — вместо этого отправьте новое сообщение.

Экспортирует локально сохранённые сообщения в виде строки JSON или CSV для архивирования, анализа или переноса. По умолчанию возвращает все сообщения из локального хранилища; используйте recipient, чтобы ограничиться одной беседой. Используйте since (дата-время в формате ISO 8601), чтобы экспортировать только сообщения после заданного момента времени. Вывод JSON сохраняет все поля (sender, timestamp, body, group_id); вывод CSV плоский и подходит для электронных таблиц. Включаются только сообщения, уже находящиеся в локальном хранилище. Сообщения, никогда не полученные на этом устройстве, отсутствуют. Используйте, когда нужен полный или отфильтрованный дамп истории переписки в машиночитаемой форме. НЕ ИСПОЛЬЗУЙТЕ для интерактивного чтения отдельных сообщений. Используйте для этого get_conversation или search_messages.

Завершает второй шаг смены номера телефона Signal, отправляя проверочный код. Должен вызываться после start_change_number, который запускает смену номера и отправляет SMS/голосовой код. number: новый номер телефона в формате E.164, на который вы переходите. verification_code: 6-значный код, полученный через SMS или голосовой вызов на этот номер. pin требуется только если в вашем аккаунте установлен PIN-код блокировки регистрации Signal, в противном случае опустите. В случае успеха аккаунт окончательно переносится на новый номер, все связанные устройства обновляются. Сначала используйте start_change_number, чтобы запросить проверочный код, перед вызовом этого инструмента. НЕ вызывайте этот инструмент без предварительного вызова start_change_number - кода не существует.

Извлекает метаданные и содержимое в кодировке base64 локально сохранённого вложения Signal по имени файла. Возвращает MIME-тип, размер файла, локальный путь и исходные байты в виде base64, чтобы вызывающий код мог прочитать или отобразить файл. Доступны только те вложения, которые уже загружены в локальное хранилище: вложения на серверах Signal истекают через ~30 дней, если их не загрузить заранее. Используйте list_attachments, чтобы узнать доступные имена файлов перед вызовом. Используйте, когда нужно прочитать, отобразить или переслать содержимое полученного файла или изображения. НЕ используйте для отправки вложения — используйте для этого send_attachment или send_group_attachment.

Извлекает фотографию профиля контакта или группы в виде данных изображения, закодированных в base64. Передайте номер телефона (E.164) для контактов или идентификатор группы (из list_groups) для групп. Возвращает необработанные байты изображения, закодированные в base64 - декодируйте, чтобы получить JPEG или PNG. Возвращает ошибку, если для идентификатора не задан аватар. Используйте get_profile, чтобы также прочитать имя и текст "about" вместе с аватаром. Используйте update_profile с avatar_path, чтобы установить свою фотографию профиля.

Получает текущую конфигурацию аккаунта Signal (подтверждения прочтения, индикаторы набора текста, предпросмотры ссылок).

Получает последнюю историю сообщений с контактом или группой из локального хранилища. Автоматически отмечает возвращённые сообщения как прочитанные в локальном хранилище (НЕ отправляет подтверждение прочтения Signal, для этого вызовите send_read_receipt).

Получает ваш собственный номер телефона Signal (учётную запись, от имени которой работает этот сервер)

Получает профиль Signal для контакта, включая его отображаемое имя, текст «О себе» и аватар. Данные профиля получаются в реальном времени из сети Signal (не из локального кэша). Используйте его для проверки текущего имени контакта или того, настроен ли у него профиль. Используйте update_profile для обновления своего профиля.

Получает одно изображение стикера в формате base64. Используйте list_sticker_packs, чтобы найти значения pack_id и sticker_id.

Получает новые непрочитанные сообщения. Если фоновый сервис (signal-mcp install-service) запущен, читает напрямую из локального хранилища. В противном случае сначала опрашивает signal-cli, чтобы получить сообщения, поступившие с момента последней проверки, а затем возвращает непрочитанные. Всегда используйте этот инструмент для проверки новых сообщений. Сообщения помечаются как прочитанные после получения. Ответ включает `has_more=true`, если за пределами лимита есть ещё непрочитанные сообщения — вызовите снова с большим лимитом или выполните пагинацию.

Проверяет, зарегистрированы ли один или несколько номеров телефонов в Signal. Запрашивает серверы Signal для каждого номера и возвращает статус зарегистрирован/не зарегистрирован. Принимает список, чтобы можно было проверить несколько номеров за один вызов. Полезно перед отправкой на неизвестный номер, чтобы избежать ошибок доставки «незарегистрированный пользователь». Примечание: аккаунты с приватным режимом или номера, которые отказались от обнаружения, могут отображаться как незарегистрированные, даже если они активно используют Signal. Используйте перед отправкой новому контакту, чтобы убедиться, что он доступен в Signal. НЕ используйте для поиска данных профиля контакта — используйте get_profile.

Выполняет полный однократный импорт всех исторических сообщений из Signal Desktop (macOS/Linux). Требуется sqlcipher. На macOS запрашивает доступ к Keychain; на Linux использует libsecret/GNOME Keyring. Для непрерывной синхронизации используйте sync_desktop.

Присоединяйтесь к группе Signal по ссылке-приглашению (https://signal.group/#...). Если группа требует одобрения администратора, ваша заявка на вступление будет ожидать рассмотрения до подтверждения. После присоединения используйте list_groups, чтобы найти group_id для отправки сообщений.

Выйдите из группы Signal. После выхода вы больше не будете получать сообщения от группы и будете удалены из списка участников. Другие участники получают уведомление о вашем выходе. Это действие необратимо без повторного приглашения. Используйте list_groups, чтобы найти group_id.

Выводит список всех аккаунтов Signal (номеров телефонов), зарегистрированных в signal-cli на этой машине. Возвращает номер телефона E.164 каждого аккаунта и его статус регистрации. В большинстве конфигураций используется один аккаунт; несколько аккаунтов появляются, если signal-cli управляет более чем одним номером. Используйте get_own_number, чтобы получить номер активного аккаунта в конфигурациях с одним аккаунтом. Используйте, когда нужно подтвердить, какие аккаунты доступны перед отправкой или получением сообщений.

Перечисляет все вложения Signal, которые были загружены и сохранены в локальном хранилище. Возвращает имена файлов, MIME-типы, размеры файлов и временную метку связанного сообщения для каждого вложения. Здесь отображаются только вложения, явно загруженные (через receive_messages или import) — вложения, ещё не полученные с серверов Signal, не перечисляются. Используйте возвращённое имя файла с get_attachment для получения фактического содержимого файла. Применяйте, когда нужно выяснить, какие медиафайлы доступны локально, прежде чем их читать. НЕ используйте для загрузки новых вложений с серверов Signal — для этого применяйте receive_messages.

Выводит все контакты Signal, известные этой учётной записи, включая имена и номера телефонов. Используйте необязательный параметр search для фильтрации по подстроке имени или номера. Возвращает контакты из локального хранилища контактов signal-cli. Используйте get_profile для получения текущего профиля Signal для конкретного контакта.

Перечисляет все разговоры (личные и групповые), отсортированные по самому последнему сообщению. Возвращает имя контакта/группы, номер телефона или group_id, превью последнего сообщения, временную метку и количество непрочитанных. Используйте это, чтобы получить обзор входящих сообщений перед чтением конкретных разговоров с помощью get_conversation. Имена контактов и групп берутся из локальных контактов и групп signal-cli. Используйте get_unread, чтобы получить только непрочитанные сообщения из всех разговоров. НЕ используйте это для чтения истории сообщений - для этого используйте get_conversation.

Перечисляет все устройства, которые в данный момент связаны с вашей учётной записью Signal, включая основное устройство и все связанные второстепенные устройства. Возвращает ID каждого устройства, имя и отметку времени последнего входа. Устройство с ID 1 всегда основное (ваш зарегистрированный телефон). Используйте возвращённые значения device_id с update_device (переименовать) и remove_device (отвязать). Используйте при проверке того, какие устройства имеют доступ к вашей учётной записи Signal, или чтобы найти ID устройства, которое вы хотите переименовать или отвязать.

Получает список всех групп Signal, к которым относится эта учётная запись, включая название группы, ID, участников и список администраторов. Возвращаемый здесь group_id необходим для send_group_message, send_group_attachment и update_group. Для изменения группы используйте update_group, а для выхода — leave_group.

Выводит ключи идентификации Signal (номера безопасности) и уровни доверия для одного или всех контактов. У каждого контакта уникальный ключ идентификации; Signal использует их для проверки целостности сквозного шифрования. Уровни доверия: TRUSTED_VERIFIED (подтверждён вручную), TRUSTED_UNVERIFIED (доверен при первом использовании, TOFU) или UNTRUSTED (ключ изменён — отправка заблокирована до повторного подтверждения). Опустите номер, чтобы просмотреть все сохранённые идентификаторы; укажите номер, чтобы отфильтровать по конкретному контакту. Используйте перед вызовом trust_identity, чтобы проверить текущее состояние доверия и отпечаток ключа. Используйте, когда Signal сообщает, что «номер безопасности изменился», чтобы определить, какой контакт требует повторной проверки. НЕ используйте для доверия или изменения уровней доверия — для этого используйте trust_identity.

Перечисляет все наборы стикеров, установленные в этой учётной записи Signal. Возвращает значения pack_id и sticker_id, необходимые для send_sticker и send_group_sticker. Используйте add_sticker_pack, чтобы установить новый набор из URL signal.art.

Помечает одно или несколько сообщений как непрочитанные в локальном хранилище signal-mcp. Обновляет только локальную базу — не влияет на уведомления о прочтении, уже отправленные отправителю, и не меняет отображение сообщений на других устройствах. message_ids — это внутренние идентификаторы signal-mcp, которые возвращают get_conversation или search_messages. Сообщения, помеченные как непрочитанные, возвращаются get_unread при следующем вызове. Используйте, когда нужно пометить сообщение для последующей обработки.

Закрепляет сообщение в личном или групповом чате, чтобы оно отображалось в заголовке беседы. Закрепление отправляет системное уведомление о закреплении всем участникам через signal-cli; они видят закреплённое сообщение выделенным вверху темы. Любой участник может закрепить любое сообщение — права администратора не требуются. В одной беседе одновременно может быть закреплено только одно сообщение; закрепление нового сообщения автоматически заменяет предыдущее. Укажите ровно один из параметров: recipient (для личного чата) или group_id (для группы). Получите target_author и target_timestamp из get_conversation — оба обязательны для идентификации сообщения. Используйте unpin_message, чтобы удалить закреплённое сообщение без замены. Используйте, когда хотите выделить важное сообщение для всех участников. НЕ используйте, если хотите просто сохранить сообщение для себя — закрепление видно всем.

Удаляет локально сохранённые сообщения старше заданного количества дней (по умолчанию: 180). НЕ удаляет сообщения с серверов Signal: только локальный кэш истории. Помогает предотвращать бесконечный рост хранилища.

Добавляет или удаляет реакцию-эмодзи на сообщение Signal в личной или групповой переписке. target_author — номер телефона отправителя исходного сообщения. target_timestamp — временная метка sent_at этого сообщения (из get_conversation). Укажите recipient для личного чата или group_id для группового — требуется ровно один из них. У каждого аккаунта может быть не более одной реакции на сообщение; повторный вызов с другим эмодзи заменяет предыдущий. Задайте remove=true, чтобы убрать существующую реакцию без добавления новой (emozi всё равно обязателен как ключ). Используйте, когда хотите отреагировать или подтвердить конкретное сообщение, не отправляя ответ. НЕ используйте для отправки текстового ответа — для этого применяйте send_message или send_group_message.

Вручную опрашивайте signal-cli на наличие новых сообщений и сохраняйте их. Предпочитайте get_unread: он делает это автоматически и возвращает результаты за один вызов. Используйте receive_messages только если хотите опрашивать без чтения результатов.

Удаляет контакт из локального списка контактов signal-cli на этом устройстве. Это удаляет только локальную запись — она НЕ блокирует контакт, не удаляет историю сообщений и не влияет на возможность контакта писать вам. Чтобы заблокировать входящие сообщения, используйте block_contact. Используйте update_contact, чтобы установить локальное отображаемое имя без удаления.

Навсегда отвязывает вторичное устройство от вашей учётной записи Signal. Устройство немедленно теряет возможность отправлять и получать сообщения. device_id должен быть вторичным устройством (ID ≥ 2): вы не можете отвязать основное устройство. Удалённое устройство не получает уведомления; оно просто перестаёт получать сообщения. Это действие необратимо: устройство должно повторно привязаться через add_device, чтобы восстановить доступ. Используйте list_devices, чтобы найти device_id, который вы хотите удалить. Используйте update_device, чтобы переименовать устройство без его удаления.

Удаляет PIN-код блокировки регистрации Signal, отключая защиту повторной регистрации для этой учётной записи. После удаления любой, кто контролирует ваш номер телефона, сможет повторно зарегистрироваться в Signal без PIN-кода. Используйте только в том случае, если вы намеренно хотите отключить блокировку регистрации. Используйте set_pin для установки нового PIN-кода вместо удаления существующего. НЕ удаляйте PIN-код, если он служит для вас мерой безопасности против атак SIM-swap.

Выполняет полнотекстовый поиск по всем локально сохранённым сообщениям по ключевому слову или фразе. Ищет в телах сообщений с помощью SQLite FTS; результаты ранжируются по релевантности. Доступны для поиска только сообщения из локального хранилища; сообщения, никогда не полученные на этом устройстве, исключаются. Используйте sender для сужения результатов до конкретного разговора. Используйте limit и offset для пагинации больших наборов результатов. Используйте, когда нужно найти конкретное сообщение или тему во всех разговорах Signal. НЕ используйте для хронологического просмотра разговора. Для этого используйте get_conversation.

Отправьте один или несколько файлов или изображений контакту в Signal. Поддерживает фото, видео, документы и аудиофайлы. Используйте path для одного файла или paths для отправки нескольких файлов одним сообщением. Установите view_once=true, чтобы отправить медиа, которое автоматически удалится после однократного просмотра получателем. Для групп используйте send_group_attachment.

Отправляет ваш локальный список контактов на все связанные устройства Signal (например, телефон, компьютер). Полезно, когда контакты, добавленные через signal-cli, не отображаются на других устройствах. Это односторонняя синхронизация с этого устройства наружу.

Отправляет один или несколько файлов (фотографии, видео, документы, аудио) в группу Signal одним сообщением. Все текущие участники группы получают вложение через обычный зашифрованный канал доставки Signal. Укажите путь к одному файлу или пути к нескольким файлам, отправляемым вместе в одном сообщении. Установите `view_once=true`, чтобы каждый участник мог открыть медиафайл только один раз, после чего он исчезнет — идеально подходит для конфиденциальных изображений; не применяется к типам документов. Файл должен существовать и быть читаемым в локальной файловой системе; несуществующие пути возвращают ошибку. Используйте `list_groups` для получения `group_id`. Используйте при отправке файла в групповой чат. НЕ используйте для личных сообщений — вместо этого используйте `send_attachment`. НЕ используйте, если нужно отправить только текст — вместо этого используйте `send_group_message`.

Отправляет текстовое сообщение в группу Signal. Сообщение доставляется всем участникам группы со сквозным шифрованием. Возвращает временн ́ую метку отправки — её можно использовать как target_timestamp для react_to_message или edit_message. Чтобы упомянуть участника ( @mention ), укажите его имя в тексте сообщения и передайте список mentions , где каждый элемент содержит start (индекс символа упоминания в тексте), length (длина в символах) и author (номер телефона в формате E.164). Чтобы ответить на сообщение или процитировать его, передайте quote_author (номер телефона отправителя) и quote_timestamp (из get_conversation). Используйте list_groups для получения значений group_id. Для отправки файлов или изображений в группу используйте send_group_attachment. НЕ используйте эту функцию для личных сообщений контакту — вместо неё вызывайте send_message.

Отправляет один стикер в группу Signal, чтобы все участники его получили. Стикеры — это маленькие изображения из установленных наборов, которые доставляются как отдельный тип сообщения: они отображаются в беседе группы, а не как вложение файла. pack_id (шестнадцатеричная строка) и sticker_id (целое число, начиная с 0) должны соответствовать установленному набору; обращение к неустановленному набору или неверному sticker_id возвращает ошибку. Используйте list_sticker_packs для просмотра установленных наборов и получения корректных значений pack_id и sticker_id. Если ни один набор не установлен, сначала вызовите add_sticker_pack с URL signal.art, чтобы установить его. Используйте list_groups для получения group_id. Применяйте, когда нужно отправить выразительную реакцию или украшение в групповой чат. Для личных сообщений используйте send_sticker. НЕ используйте для отправки обычного изображения — для этого применяйте send_group_attachment.

Отправляет текстовое сообщение контакту в Signal. Сообщение доставляется со сквозным шифрованием. Возвращает временную метку отправки, которую можно использовать как target_timestamp для react_to_message или edit_message. Чтобы ответить или процитировать конкретное сообщение, укажите quote_author и quote_timestamp (временные метки можно получить из get_conversation). Используйте send_group_message для групповых чатов, send_attachment для файлов/изображений.

Принимает или отклоняет запрос сообщения от неизвестного контакта (требуется перед ответом незнакомцам)

Отправляет заметку самому себе через функцию Signal 'Note to Self' / сохранённые сообщения. Заметка синхронизируется на всех ваших связанных устройствах Signal. Полезна для сохранения напоминаний, закладок или черновиков, которые синхронизируются с вашим телефоном.

Отправляет уведомление о прочтении контакту, сообщая, что вы прочитали их сообщения. Отправитель видит индикатор 'Read' под своими сообщениями в приложении Signal. Передавайте все метки времени, которые хотите отметить как прочитанные, в одном вызове, чтобы отправить их пакетом. Метки времени берутся из полей received_at или sent_at в get_conversation. Примечание: уведомления о прочтении доставляются только в том случае, если у отправителя включены уведомления о прочтении в настройках Signal. Используйте после чтения беседы с помощью get_conversation, чтобы подтвердить прочтение сообщений. НЕ используйте, чтобы отметить сообщения как прочитанные в локальном хранилище - get_conversation делает это автоматически. НЕ используйте для групповых сообщений: Signal не поддерживает уведомления о прочтении для каждого отправителя в группах.

Отправляет один стикер контакту Signal в личном сообщении. Стикеры - это маленькие изображения из установленных наборов, которые доставляются как отдельный тип сообщения: они отображаются прямо в диалоге, а не как вложение файла. И pack_id (шестнадцатеричная строка), и sticker_id (целое число, начиная с 0) должны соответствовать установленному набору; обращение к неустановленному набору или неверному sticker_id возвращает ошибку. Для просмотра всех установленных наборов и получения корректных значений pack_id и sticker_id используйте list_sticker_packs. Если наборы не установлены, сначала вызовите add_sticker_pack с signal.art URL для установки. Используйте этот инструмент, когда хотите отправить контакту выразительную реакцию или украшение в виде изображения. Для отправки стикера в группу вместо личного сообщения используйте send_group_sticker. НЕ используйте для отправки обычного изображения - для этого используйте send_attachment.

Запрашивает полную синхронизацию сообщений, контактов и групп с основного устройства Signal на это связанное устройство. Архитектура связанных устройств Signal хранит историю на основном устройстве; синхронизация переносит эти данные сюда. Используйте, когда list_conversations не показывает историю, list_contacts возвращает меньше контактов, чем ожидалось, или list_groups не содержит групп, которые есть на вашем телефоне. Синхронизация асинхронна, данные поступают в фоне в течение нескольких секунд. НЕ используйте для получения новых входящих сообщений, для этого используйте receive_messages.

Устанавливает или отключает таймер исчезающих сообщений для личного или группового разговора. После установки все новые сообщения автоматически удаляются через expiration_seconds с обеих сторон. Типичные значения: 3600 (1ч), 86400 (1д), 604800 (1н), 2592000 (30д). Установите expiration_seconds=0, чтобы полностью отключить исчезающие сообщения. Укажите recipient для личного разговора или group_id для группы, требуется ровно одно. Изменение доставляется всем участникам и вступает в силу для новых сообщений немедленно; уже отправленные сообщения не затрагиваются. Используйте, когда нужна автоматическая приватность для конфиденциального разговора.

Устанавливает PIN блокировки регистрации Signal для защиты аккаунта от SIM-свопинга и повторной регистрации без разрешения. После установки любой, кто попытается повторно зарегистрировать ваш номер телефона в Signal, должен будет ввести этот PIN. PIN должен содержать от 4 до 20 цифр. Signal также использует PIN для получения ключа шифрования хранилища. Если вы забудете PIN, вам придется подождать 7 дней до истечения блокировки, прежде чем зарегистрироваться заново. Используйте, когда хотите усилить защиту аккаунта от SIM-свопинга. Используйте remove_pin для отключения блокировки. НЕ устанавливайте PIN, который вы можете забыть. Его потеря блокирует вам доступ к аккаунту на 7 дней.

Отправляет индикатор 'typing…' контакту Signal, чтобы показать, что вы набираете сообщение. Индикатор появляется сразу в беседе получателя и автоматически исчезает через ~15 секунд, если сообщение не отправлено. Вам не нужно вызывать stop=true после отправки сообщения. Вызывайте с stop=true, чтобы досрочно отменить активный индикатор набора (например, если пользователь отказался от сообщения). signal-cli передаёт индикатор через протокол Signal; если получатель отключил индикаторы набора в настройках, они молча игнорируются на его стороне. Ошибка не возвращается. Индикаторы набора поддерживаются только для личных сообщений один на один; передача group_id недопустима. Используйте перед send_message, чтобы создать реалистичный эффект 'typing' в автоматическом рабочем процессе. НЕ используйте для групп: индикаторы набора для групп не поддерживаются Signal. НЕ вызывайте повторно в плотном цикле; одного вызова на сеанс набора достаточно.

Начинает перенос учётной записи Signal на новый номер телефона. Signal отправляет 6-значный проверочный код на новый номер через SMS (или через голосовой звонок, если voice=true). После вызова этого инструмента вызовите finish_change_number с новым номером и полученным кодом, чтобы завершить перенос. Если Signal отклоняет запрос из-за ограничений по частоте, предоставьте капча-токен, полученный с https://signalcaptchas.org/challenge/generate.html. Учётная запись остаётся на старом номере до тех пор, пока finish_change_number не выполнится успешно. Используйте finish_change_number сразу после получения SMS-кода, чтобы завершить смену. НЕ вызывайте finish_change_number без предварительного вызова этого инструмента — проверочный код не будет существовать.

Получает статистику о локально хранимых сообщениях (количество, количество непрочитанных, размер БД на диске, диапазон дат).

Разблокирует аккаунт после того, как Signal применит ограничение скорости. Предоставляет токен вызова из ошибки и решённую капчу с https://signalcaptchas.org/challenge/generate.html

Инкрементальная синхронизация из Signal Desktop: импортирует только сообщения новее последней синхронизации. Быстро при повторных вызовах. При первом вызове работает как import_desktop (импортирует всё). Требует sqlcipher.

Закрывает (завершает) опрос, созданный вами, останавливая любое дальнейшее голосование. Уведомляет всех участников о завершении опроса, и они могут увидеть окончательные результаты. Получает target_timestamp и poll_id из исходного сообщения опроса в get_conversation. Только создатель опроса может завершить свой собственный опрос. Предоставляет либо recipient (для опроса в личных сообщениях), либо group_id (для опроса в группе).

Доверяет ключу идентификации контакта Signal после верификации его Safety Number вне канала. Signal использует ключи идентификации (Safety Number) для верификации сквозного шифрования. Когда Safety Number контакта меняется (например, он переустановил Signal), отправка не удаётся, пока вы явно не доверяете новому ключу. Этот инструмент снимает эту блокировку. Укажите safety_number, чтобы доверять только этому конкретному верифицированному ключу; оставьте пустым, чтобы доверять всем известным ключам для этого номера (менее безопасно, но разблокирует доставку немедленно). Используйте list_identities для проверки текущего уровня доверия и отпечатка ключа перед вызовом. Используйте, когда Signal блокирует доставку с ошибками 'untrusted identity' или 'safety number changed'. НЕ доверяйте без предварительной верификации Safety Number через доверенный канал (лично, по телефону). Доверие непроверенному ключу обходит TOFU-верификацию идентичности Signal.

Разблокирует ранее заблокированный контакт Signal, восстанавливая его возможность отправлять вам сообщения и совершать звонки. Контакт НЕ уведомляется о том, что его разблокировали. Используйте block_contact, чтобы снова заблокировать, или list_contacts, чтобы посмотреть, какие контакты заблокированы.

Открепляет ранее закреплённое сообщение в личном или групповом разговоре, удаляя его из заголовка. Укажите recipient (для личных сообщений) или group_id (для групп). Получите target_author и target_timestamp с помощью get_conversation. Для закрепления сообщения используйте pin_message.

Обновляет настройки конфиденциальности и идентификации на уровне аккаунта Signal. Все параметры необязательны: укажите только те настройки, которые хотите изменить. discoverable_by_number управляет тем, могут ли другие найти вас по номеру телефона. number_sharing управляет тем, передаётся ли ваш номер контактам, которым вы пишете. username устанавливает псевдоним @username; delete_username удаляет его. Для настроек обмена сообщениями (уведомления о прочтении, индикаторы набора текста) используйте get_configuration.

Обновляет общеучётные настройки сообщений Signal. read_receipts управляет тем, уведомляет ли Signal отправителей о прочтении их сообщений. typing_indicators управляет тем, видят ли контакты индикатор '...' при наборе текста. link_previews управляет тем, создаются ли встроенные предпросмотры URL в исходящих сообщениях. unidentified_delivery_indicators управляет отображением иконок доставки sealed-sender. Все параметры необязательны — пропустите любую настройку, которую не хотите менять. Изменения вступают в силу немедленно и сохраняются между сеансами. Используйте get_configuration для чтения текущих значений перед изменением. Используйте update_account для настроек приватности уровня аккаунта (обнаруживаемость, имя пользователя). НЕ используйте для изменения имени или фото профиля — для этого используйте update_profile.

Устанавливает или обновляет локальное отображаемое имя для контакта Signal. Имя хранится только в локальной базе контактов signal-cli - оно никогда не отправляется контакту и не видно ему. Переопределяет собственное имя профиля контакта в list_contacts и отображении переписки. Полезно для добавления читаемой подписи к номеру, у которого нет имени профиля Signal. Используйте list_contacts, чтобы посмотреть текущие имена перед обновлением. Используйте, когда хотите назначить или исправить отображаемое имя контакта локально. НЕ ИСПОЛЬЗУЙТЕ для изменения своего собственного имени профиля - для этого используйте update_profile. НЕ ИСПОЛЬЗУЙТЕ для блокировки или удаления контакта - для этого используйте block_contact или remove_contact.

Переименовывает связанное вторичное устройство в вашей учётной записи Signal. Обновлённое имя синхронизируется с сетью Signal и сразу отображается в списке Settings → Linked Devices в приложении Signal на всех ваших устройствах. Переименовать можно только вторичные (связанные) устройства; имя основного устройства задаётся при регистрации. Используйте list_devices, чтобы найти все идентификаторы связанных устройств и их текущие имена. device_id — это небольшое целое число (например, 2, 3); устройство 1 всегда основное. Переименование не влияет на возможность устройства отправлять и получать сообщения. Применяйте, когда хотите различить несколько связанных устройств с помощью осмысленной подписи. Используйте remove_device, чтобы полностью отвязать устройство. НЕ используйте для переименования собственного основного аккаунта — для этого предназначена update_profile.

Изменяет настройки, состав участников или разрешения группы Signal. Все параметры, кроме group_id, опциональны — указывайте только то, что хотите изменить. add_members отправляет приглашения; remove_members удаляет участников немедленно. add_admins повышает участников до администраторов; remove_admins понижает их обратно. expiration_seconds задаёт таймер исчезающих сообщений (0 — отключить). link_mode управляет ссылкой-приглашением: 'enabled' (любой по ссылке может присоединиться), 'enabled-with-approval' (администратор должен одобрить), 'disabled' (ссылка отключена) или 'reset' (создать новую ссылку и сделать старую недействительной). Изменения применяются мгновенно, все участники получают уведомление об обновлении. Вы должны быть администратором группы, чтобы изменять состав, список администраторов или ссылку-приглашение. Используйте list_groups, чтобы получить group_id и подтвердить свой статус администратора. НЕ используйте для отправки сообщения. Для этого применяйте send_group_message.

Обновляет ваш собственный профиль Signal, видимый всем контактам. `name` задаёт отображаемое имя, которое видят контакты, не сохранившие ваш номер. `about` задаёт текст биографии на странице профиля. `avatar_path` устанавливает новую фотографию профиля из локального файла изображения (JPEG или PNG). Установите `remove_avatar=true`, чтобы удалить текущую фотографию, не загружая новую. Все параметры необязательны — включайте только то, что хотите изменить. Изменения распространяются в сеть Signal немедленно. Используйте `get_profile`, чтобы прочитать текущий профиль контакта. НЕ ИСПОЛЬЗУЙТЕ для переименования связанного устройства — для этого используйте `update_device`. НЕ ИСПОЛЬЗУЙТЕ для изменения настроек сообщений — для этого используйте `update_configuration`.

Упаковывает и публикует набор стикеров в CDN Signal из локальных файлов изображений. Принимает локальный файл manifest.json, описывающий набор, или zip-архив, содержащий и манифест, и изображения. CDN Signal сохраняет набор и возвращает установочный URL вида signal.art, которым вы можете поделиться с другими. Получатели вызывают add_sticker_pack с этим URL, чтобы установить набор и отправлять его стикеры. После публикации набор доступен в сети Signal бессрочно. Используйте, когда хотите создать и распространить собственный набор стикеров. Используйте add_sticker_pack, чтобы установить существующий набор для отправки. НЕ используйте для установки набора — для этого используйте add_sticker_pack.

Голосует в активном опросе Signal в личном сообщении или групповом чате. Голос отправляется через signal-cli и становится виден всем участникам в реальном времени. Каждый участник может проголосовать один раз; повторное голосование перезаписывает предыдущий выбор. Для опросов с одним вариантом укажите ровно один индекс варианта в votes. Для опросов с множественным выбором укажите все выбранные индексы в одном вызове: частичные обновления не поддерживаются. votes — это индексы, начиная с 0, соответствующие массиву options из исходного вызова create_poll. Получите target_author, target_timestamp и poll_id из сообщения опроса, возвращаемого get_conversation. Укажите ровно один из параметров: recipient (для опроса в личном сообщении) или group_id (для опроса в групповом чате). Голосование в завершённом опросе возвращает ошибку. Используйте terminate_poll, чтобы закрыть созданный вами опрос и заморозить результаты. Используйте при ответе на открытый опрос в чате. НЕ используйте для создания опроса. Вместо этого используйте create_poll.