SMS-connectivité Premium Fortumo: spécifications technique

message

Le contenu du message moins les mots clés. Ainsi, si le message a été TXT KEY 123, alors ce paramètre est 123. Le paramètre est vide si il n'y a que le mot-clé et aucun autre texte dans le message.

sender

Le numéro de téléphone de l'expediteur au format international sans le signe plus. Par exemple, 4560123456 ou 358401234567.

country

Le code du pays de l'opérateur de téléphonie mobile de l'expéditeur. Deux codes de caractères sont utilisés selon la norme ISO 3166-1 (SE pour la Suède, FI - Finlande, NO - Norvège, LT - Lituanie LV - Lettonie, EE - Estonie, etc.) Veuillez noter également que ce n'est pas nécessairement la localisation réelle de l'expéditeur. Par exemple, l'expéditeur avec un téléphone suédois, peut être à l'origine de l'envoi d'un message en étant en Norvège, vous aurez quand même SE dans le champs "pays".

price

Prix pour l'utilisateur final du message dans la monnaie locale, TVA comprise.

currency

Le symbole de la monnaie locale selon la norme ISO 4217 (EUR, SEK, NOK, DKK, LTL, LVL, EEK, USD, GBP, etc.)

service_id

Une chaîne de caractères qui identifie ce service Fortumo . Par exemple f7fa12b381d290e268f99e382578d64a. Si vous avez beaucoup de services avec la même URL, vous pouvez utiliser ce champ pour déterminer à quel service le message est destiné.

message_id

Une chaîne de caractères qui est unique pour chaque message que reçoit votre service.

keyword

Le mot clé fait partie du message. Ainsi, si le message a été TXT KEY 123, alors ce paramètre est TXT KEY.

shortcode

Le short code auquel le message a été envoyé.

operator

Nom de l'opérateur mobile de l'expéditeur

billing_type

Peut être MO ou MT. En savoir plus sur les type de facturation dans laFAQ Fortumo.

status

Le statut de la facturation, est soit en attente(dans la demande de remise de message), soit ok ou bien échoué(dans le rapport de facture).

test

Ce paramètre est présent uniquement lorsque le message est envoyé par le biais de l'interface de test Fortumo, par vous-même. Il a toujours la valeur 'true'.

sig

Demande de signature que vous pouvez vérifier, afin de s'assurer que la requête est originaire de Fortumo. Voir ci-dessous comment faire de la manière la plus sûre possible.

<?php

  //set true if you want to use script for billing reports
  //first you need to enable them in your account
  $billing_reports_enabled = false;

  // check that the request comes from Fortumo server
  if(!in_array($_SERVER['REMOTE_ADDR'],
      array('81.20.151.38', '81.20.148.122', '209.20.83.207'))) {
    die("Error: Unknown IP");
  }

  // check the signature
  $secret = ''; // insert your secret between ''
  if(!empty($secret) && !check_signature($_GET, $secret)) {
    die("Error: Invalid signature");
  }

  $sender = $_GET['sender'];
  $message = $_GET['message'];

  // do something with $sender and $message
  $reply = "Thank you $sender for sending $message";

  // print out the reply
  echo($reply);
 
 //customize this according to your needs
  if($billing_reports_enabled 
    && preg_match("/Failed/i", $_GET['status']) 
    && preg_match("/MT/i", $_GET['billing_type'])) {
   // find message by $_GET['message_id'] and suspend it
  }


  function check_signature($params_array, $secret) {
    ksort($params_array);

    $str = '';
    foreach ($params_array as $k=>$v) {
      if($k != 'sig') {
        $str .= "$k=$v";
      }
    }
    $str .= $secret;
    $signature = md5($str);

    return ($params_array['sig'] == $signature);
  }
?>