NAME

Mojar::Message::Telegram - Send messages via Telegram.

SYNOPSIS

  use Mojar::Message::Telegram;
  my $msg = Mojar::Message::Telegram->new(message => ..., recipient => ...);

  # Synchronous
  $msg->send(
    message   => q{Don't you love the bot API? \N{U+2714} },
    recipient => '111222333',
  );

  # Asynchronous
  my @error;
  $sms->send(
    message   => q{Fire and forget; with a reminder},
    recipient => '111222333',
    sub { $error[0] = $_[1] }
  );

DESCRIPTION

Sends simple messages via Telegram. You need to know the chat_id of each recipient, and they must have initiated some interaction with your bot beforehand.

ATTRIBUTES

• address

    $msg->address;  # defaults to api.telegram.org
    $msg->address('somewhere.web.telegram.org');

• token

    $msg->token('123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11');

• ua

    $msg->ua($this_agent);
    my $ua = $msg->ua;

  The user agent persists in an attribute of the object and you can supply your own at creation time.

METHODS

new

  $msg = Mojar::Message::Telegram->new(token => ...);

Constructor for the Telegram agent.

send

  $msg->send(message => q{...}, recipient => $recipient);

Supports method chaining, and will bail-out at the first failure if no callback is given. Supports asynchronous calls when provided a callback as the final argument.

  $msg->send(message => q{...}, recipient => ..., sub {
    my ($agent, $error) = @_;
    ...
  });

  $sms->send(message => $m, recipient => $r, sub { ++$error_count if $_[1] });

You can also send messages without triggering a notification by including the quiet = 1> parameter.

REFERENCE

https://core.telegram.org/bots/api shows the Bot API.

CONFIGURATION AND ENVIRONMENT

You need to create an account following https://core.telegram.org/bots.

SUPPORT

See Mojar.

SEE ALSO

WWW::Telegram::BotAPI.