Модуль community.general.twilio — отправляет текстовое сообщение на мобильный телефон через Twilio

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.twilio.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры

Краткое описание

Отправляет текстовое сообщение на номер телефона через API обмена сообщениями Twilio.

Параметры

Параметр	Комментарии
account_sid string / обязательный	Токен учётной записи Twilio пользователя, указанный на странице учётной записи.
auth_token string / обязательный	Токен аутентификации Twilio пользователя.
from_number string / обязательный	Номер Twilio, с которого отправляется текстовое сообщение, в формате `+15551112222`.
media_url string	URL-адрес изображения, видео или аудиозаписи для отправки в MMS (мультимедийном сообщении) вместо обычного SMS.
msg string / обязательный	Текст сообщения.
to_numbers псевдонимы: to_number list / элементы=string / обязательный	Один или несколько номеров телефонов для отправки текстового сообщения в формате `+15551112222`.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в `check_mode` и возвращать прогноз статуса изменений, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме сравнения возвращает сведения о том, что изменилось (или, возможно, требует изменения в `check_mode`).

Примечания

Примечание

Этот модуль не является идемпотентным, поскольку отправляет электронное письмо через внешний API. Он идемпотентен только в случае сбоя модуля.
Как и другим модулям уведомлений, для работы этому модулю требуется внешняя зависимость. В данном случае для отправки текстового сообщения необходима учётная запись Twilio с приобретённым или подтверждённым номером телефона.

Примеры

# send an SMS about the build status to (555) 303 5681
# note: replace account_sid and auth_token values with your credentials
# and you have to have the 'from_number' on your Twilio account
- name: Send a text message to a mobile phone through Twilio
  community.general.twilio:
    msg: All servers with webserver role are now configured.
    account_sid: ACXXXXXXXXXXXXXXXXX
    auth_token: ACXXXXXXXXXXXXXXXXX
    from_number: "+15552014545"
    to_number: "+15553035681"
  delegate_to: localhost

# send an SMS to multiple phone numbers about the deployment
# note: replace account_sid and auth_token values with your credentials
# and you have to have the 'from_number' on your Twilio account
- name: Send a text message to a mobile phone through Twilio
  community.general.twilio:
    msg: This server configuration is now complete.
    account_sid: ACXXXXXXXXXXXXXXXXX
    auth_token: ACXXXXXXXXXXXXXXXXX
    from_number: "+15553258899"
    to_numbers:
      - "+15551113232"
      - "+12025551235"
      - "+19735559010"
  delegate_to: localhost

# send an MMS to a single recipient with an update on the deployment
# and an image of the results
# note: replace account_sid and auth_token values with your credentials
# and you have to have the 'from_number' on your Twilio account
- name: Send a text message to a mobile phone through Twilio
  community.general.twilio:
    msg: Deployment complete!
    account_sid: ACXXXXXXXXXXXXXXXXX
    auth_token: ACXXXXXXXXXXXXXXXXX
    from_number: "+15552014545"
    to_number: "+15553035681"
    media_url: https://demo.twilio.com/logo.png
  delegate_to: localhost

Авторы

Matt Makai (@makaimc)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/twilio_module.html