Nota

Este complemento es parte del colección community.general (versión 2.0.1).

Para instalarlo usa: ansible-galaxy collection install community.general.

Para usarlo en un libro de jugadas, especifique: community.general.telegram.

  • Sinopsis
  • Parámetros
  • notas
  • Ejemplos
  • Valores devueltos

Sinopsis

  • Envía notificaciones a través del bot de Telegram a un grupo o usuario verificado.
  • Además, el usuario puede intentar usar cualquier otro método API de bot de Telegram, si especifica método_api argumento.

Parámetros

Parámetro Opciones/Predeterminados Comentarios
api_argsdiccionario agregado en 2.0.0 de community.general Cualquier parámetro para el método. Para referencia al método predeterminado, SendMessagever https://core.telegram.org/bots/api#sendmessage.
método_apistring agregado en 2.0.0 de community.general Defecto:
“Enviar mensaje”
Método Bot API. Para referencia, consulte https://core.telegram.org/bots/api.
chat_idstring (Obsoleto) Grupo de Telegram o usuario chat_id.
mensajestring (Obsoleto) Qué mensaje desea enviar.
formato_mensajestring
    Opciones:

  • sencillo
  • reducción
  • MarkdownV2
  • html
(Obsoleto) Formato de mensaje. Opciones de formato markdown, MarkdownV2y html descrito en los documentos de la API de Telegram (https://core.telegram.org/bots/api#formatting-options). Si la opción plain configurado, el mensaje no se formateará.
simbólicostring / requerido Token que identifica tu bot de Telegram.

notas

Nota

  • Necesitará una cuenta de Telegram y creará un bot de Telegram para usar este módulo.
  • Las opciones mensaje, formato_mensaje y chat_id han quedado en desuso y se eliminarán en community.general 4.0.0. Utilice las variables correspondientes en api_args en cambio. Vea los ejemplos de cómo funciona.

Ejemplos

-name: Send notify to Telegram
  community.general.telegram:token:'9999999:XXXXXXXXXXXXXXXXXXXXXXX'api_args:chat_id:000000parse_mode:"markdown"text:"Your precious application has been deployed: https://example.com"disable_web_page_preview:Truedisable_notification:True-name: Forward message to someone
  community.general.telegram:token:'9999999:XXXXXXXXXXXXXXXXXXXXXXX'api_method: forwardMessage
    api_args:chat_id:000000from_chat_id:111111disable_notification:Truemessage_id:' saved_msg_id '-name: Send a message to chat in playbook (deprecated old style)
  community.general.telegram:token:'9999999:XXXXXXXXXXXXXXXXXXXXXXX'chat_id:000000msg: Ansible task finished

Valores devueltos

Los valores de retorno comunes están documentados aquílos siguientes son los campos exclusivos de este módulo:

Llave devuelto Descripción
mensajestring éxito El mensaje que intentaste enviar
Muestra:Tarea de Ansible terminada
telegrama_errorstring falla Mensaje de error recibido de la API de Telegram
Muestra:Solicitud incorrecta: el texto del mensaje está vacío

Autores

  • Artem Feofanov (@tyouxa)
  • Nikolái Lomov (@lomserman)