| 1 | package Net::SMS::WorldText; | ||
| 2 | |||
| 3 | use strict; | ||
| 4 | use warnings; | ||
| 5 | |||
| 6 | use Carp qw(confess); | ||
| 7 | use LWP::UserAgent; | ||
| 8 | use URI::Escape; | ||
| 9 | |||
| 10 | our $VERSION = "1.3"; | ||
| 11 | |||
| 12 | require Exporter; | ||
| 13 | our @ISA = qw(Exporter); | ||
| 14 | our @EXPORT; | ||
| 15 | |||
| 16 | our %errhash = ( | ||
| 17 | ARGUMENTS => "Wrong number of arguments", | ||
| 18 | AUTHORISATION => "Login/password incorrect", | ||
| 19 | BLACKLISTED => "Blacklisted MSISDN", | ||
| 20 | CREDIT => "Not enough credit", | ||
| 21 | DESTINATION => "Incorrect MSISDN", | ||
| 22 | DISABLED => "Account suspended, contact support", | ||
| 23 | EXCEPTION => "Internal Server Error", | ||
| 24 | INTERNAL => "Internal routing error, please retry", | ||
| 25 | INVALIDARGS => "Invalid arguments", | ||
| 26 | KEYEXPIRED => "Authentication key expired", | ||
| 27 | MESSAGEID => "Invalid or blank message id", | ||
| 28 | SOURCEADDR => "Unallocated source address", | ||
| 29 | SUBMITRESP => "Incorrect SMPP response received, please retry", | ||
| 30 | TIMEOUT => "SMPP request timed out, please retry", | ||
| 31 | THROTTLED => "Request throttled, retry in 20 seconds", | ||
| 32 | UNKNOWNCMD => "Unknown command", | ||
| 33 | VERSION => "Incorrect interface version specified", | ||
| 34 | SQL => "Number already exists in group", # Guessing, based on trying to add a number twice | ||
| 35 | ); | ||
| 36 | |||
| 37 | sub new { | ||
| 38 | my ($class, %opts) = @_; | ||
| 39 | my $self = { | ||
| 40 | user => $opts{user}, | ||
| 41 | pass => $opts{pass}, | ||
| 42 | proxyapi => $opts{proxyapi}, | ||
| 43 | baseurl => $opts{proxyapi} ? | ||
| 44 | 'https://www.world-text.com/proxyapi/' : | ||
| 45 | 'https://sms.world-text.com:1082/', | ||
| 46 | ua => LWP::UserAgent->new, | ||
| 47 | }; | ||
| 48 | return bless($self, $class); | ||
| 49 | } | ||
| 50 | |||
| 51 | sub __request { | ||
| 52 | my ($self, $request, %args) = @_; | ||
| 53 | if($request !~ /authkey|ping/) { | ||
| 54 | $args{user} = $self->{user}; | ||
| 55 | $args{pass} = $self->{pass}; | ||
| 56 | } | ||
| 57 | if(exists $args{dstaddr}) { | ||
| 58 | $args{dstaddr} =~ s/[^0-9,]//g; | ||
| 59 | } | ||
| 60 | my $req = HTTP::Request->new("POST" => $self->{baseurl} . $request); | ||
| 61 | $req->content_type('application/x-www-form-urlencoded'); | ||
| 62 | if(%args) { | ||
| 63 | $req->content(join('&', map { sprintf("%s=%s", $_, uri_escape($args{$_})) } keys(%args))); | ||
| 64 | } | ||
| 65 | my $res = $self->{ua}->request($req); | ||
| 66 | if(!$res->is_success) { | ||
| 67 | confess("HTTP request to WorldText failed: " . $res->status_line); | ||
| 68 | } | ||
| 69 | my $content = $res->content; | ||
| 70 | $content =~ s/^\s*(.*?)\s*$/$1/s; | ||
| 71 | if($content =~ /^FAIL (.*)/s) { | ||
| 72 | my $err = $errhash{$1} || $1; | ||
| 73 | confess "API request failed: $err"; | ||
| 74 | } | ||
| 75 | if($content =~ /SUCCESS (.*)/s) { | ||
| 76 | return $1; | ||
| 77 | } | ||
| 78 | return $content; | ||
| 79 | } | ||
| 80 | |||
| 81 | sub ping { | ||
| 82 | my ($self) = @_; | ||
| 83 | $self->__request("ping"); | ||
| 84 | } | ||
| 85 | |||
| 86 | sub credits { | ||
| 87 | my ($self) = @_; | ||
| 88 | $self->__request("credits"); | ||
| 89 | } | ||
| 90 | |||
| 91 | sub send { | ||
| 92 | my ($self, %opts) = @_; | ||
| 93 | my $dest = delete $opts{dest}; | ||
| 94 | $dest = join(',', ref($dest) ? @$dest : ( $dest, )); | ||
| 95 | my $ret = $self->__request("sendsms", txt=>delete $opts{message}, dstaddr=>$dest, %opts); | ||
| 96 | $ret =~ s/SUCCESS //g; | ||
| 97 | my @ret; | ||
| 98 | for my $line (split /\r\n/, $ret) { | ||
| 99 | my @line = split / /, $line; | ||
| 100 | push @ret, \@line; | ||
| 101 | } | ||
| 102 | return \@ret; | ||
| 103 | } | ||
| 104 | |||
| 105 | sub query { | ||
| 106 | my ($self, $msgid) = @_; | ||
| 107 | return $self->__request("querysms", msgid=>$msgid); | ||
| 108 | } | ||
| 109 | |||
| 110 | sub group { | ||
| 111 | my ($self, $group) = @_; | ||
| 112 | return Net::SMS::WorldText::Group->new($self, $group); | ||
| 113 | } | ||
| 114 | |||
| 115 | sub create_group { | ||
| 116 | my ($self, %opts) = @_; | ||
| 117 | return Net::SMS::WorldText::Group->create($self, $opts{name}, $opts{srcaddr}, $opts{pin}); | ||
| 118 | } | ||
| 119 | |||
| 120 | sub __normalize { | ||
| 121 | my ($number) = @_; | ||
| 122 | $number =~ s/[^0-9]//g; | ||
| 123 | } | ||
| 124 | |||
| 125 | 1; | ||
| 126 | |||
| 127 | package Net::SMS::WorldText::Group; | ||
| 128 | |||
| 129 | use strict; | ||
| 130 | use warnings; | ||
| 131 | |||
| 132 | sub new { | ||
| 133 | my ($class, $wt, $group) = @_; | ||
| 134 | my $self = { | ||
| 135 | wt => $wt, | ||
| 136 | grpid => $group, | ||
| 137 | }; | ||
| 138 | return bless($self, $class); | ||
| 139 | } | ||
| 140 | |||
| 141 | sub create { | ||
| 142 | my ($class, $wt, $name, $srcaddr, $pin) = @_; | ||
| 143 | $name = substr($name, 0, 20); | ||
| 144 | my $grpid = $wt->__request("groupcreate", name=>$name, srcaddr=>$srcaddr, pin=>$pin); | ||
| 145 | return $class->new($wt, $grpid); | ||
| 146 | } | ||
| 147 | |||
| 148 | sub add { | ||
| 149 | my ($self, $number, $name) = @_; | ||
| 150 | $name = substr($name, 0, 20); | ||
| 151 | $self->{wt}->__request("groupadd", grpid=>$self->{grpid}, dstaddr=>$number, name=>$name); | ||
| 152 | } | ||
| 153 | |||
| 154 | sub del { | ||
| 155 | my ($self, $number) = @_; | ||
| 156 | $self->{wt}->__request("groupdel", grpid=>$self->{grpid}, dstaddr=>$number); | ||
| 157 | } | ||
| 158 | |||
| 159 | sub delall { | ||
| 160 | my ($self) = @_; | ||
| 161 | $self->{wt}->__request("groupdelall", grpid=>$self->{grpid}); | ||
| 162 | } | ||
| 163 | |||
| 164 | sub list { | ||
| 165 | my ($self) = @_; | ||
| 166 | my $group = $self->{wt}->__request("groupget", grpid=>$self->{grpid}); | ||
| 167 | |||
| 168 | my @group = map { '+' . $_} split /\r\n/, $group; | ||
| 169 | return \@group; | ||
| 170 | } | ||
| 171 | |||
| 172 | sub details { | ||
| 173 | my ($self) = @_; | ||
| 174 | my $group = $self->{wt}->__request("groupgetdetails", grpid=>$self->{grpid}); | ||
| 175 | my %group = (); | ||
| 176 | for my $user (split /\r\n/, $group) { | ||
| 177 | $user =~ /"(.*?)","(.*?)"/; | ||
| 178 | $group{$2} = "+$1"; | ||
| 179 | } | ||
| 180 | return \%group; | ||
| 181 | } | ||
| 182 | |||
| 183 | sub send { | ||
| 184 | my ($self, $message, %opts) = @_; | ||
| 185 | $self->{wt}->__request("sendgroup", grpid=>$self->{grpid}, txt=>$message, %opts); | ||
| 186 | } | ||
| 187 | |||
| 188 | sub remove { | ||
| 189 | my ($self) = @_; | ||
| 190 | eval { | ||
| 191 | $self->{wt}->__request("groupremove", grpid=>$self->{grpid}); | ||
| 192 | 1; | ||
| 193 | } or do { | ||
| 194 | return "SUCCESS" if($@ =~ /Number already exist/); | ||
| 195 | die; | ||
| 196 | } | ||
| 197 | } | ||
| 198 | |||
| 199 | 1; | ||
| 200 | |||
| 201 | __END__ |