googlarz/signal-mcp

Привязывает новое дополнительное устройство к вашей учётной записи Signal с помощью URI для привязки устройства. Этот URI создаётся на новом устройстве при запуске 'signal-cli link' или при сканировании QR-кода в Signal Desktop в разделе Settings → Linked Devices → Link New Device. После привязки новое устройство получает будущие сообщения, но не исторические. Используйте list_devices, чтобы убедиться, что устройство успешно привязано. Используйте remove_device, чтобы отвязать устройство, которым больше не пользуетесь. НЕ передавайте 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 (group): требуется ровно одно из них. Возвращает временную метку опроса, необходимую для 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, если непрочитанных сообщений больше, чем помещается в limit: вызовите снова с большим значением limit или используйте пагинацию.

Проверяет, зарегистрированы ли один или несколько номеров телефонов в 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. Используйте только если вы намеренно хотите отключить блокировку регистрации. Чтобы установить новый PIN вместо удаления текущего, используйте set_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. Чтобы упомянуть участника через @, добавьте его имя в текст сообщения и передайте список 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-swap и несанкционированной повторной регистрации. После установки любой, кто попытается повторно зарегистрировать ваш номер телефона в Signal, должен будет ввести этот PIN. PIN должен состоять из 4–20 цифр. Signal также использует PIN, чтобы получить ключ шифрования хранилища. Если вы забудете PIN, придётся подождать 7 дней, пока блокировка не истечёт, прежде чем повторно регистрироваться. Используйте, когда хотите защитить аккаунт от SIM-swap-атак. Используйте 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 не завершится успешно. Сразу после получения SMS-кода используйте finish_change_number, чтобы завершить смену. НЕ вызывайте 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. Для настроек приватности на уровне аккаунта (discoverability, username) используйте update_account. НЕ используйте его для смены имени или фото профиля - для этого используйте update_profile.

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

Переименовывает связанное вторичное устройство в вашем аккаунте Signal. Обновлённое имя синхронизируется с сетью Signal и сразу появляется в списке Настройки → Связанные устройства в приложении 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.