Créer une liste

Cette méthode vous permet de créer une liste de contacts. Chaque contact peut posséder jusqu'à 4 informations personnalisées. Ces informations peuvent ensuite être affichées dans chaque message. Par exemple, si vous insérez [info1] dans votre texte, ce sera automatiquement remplacé par l'information du contact correspondante.

POST

/list

Paramètres du body

value
requis
Le numéro du destinataire au format E.164
name Le nom de la liste. Si aucun nom n'est fourni, la date de création sera le nom par défaut
info1 Information 1
info2 Information 2
info3 Information 3
info4 Information 4

Exemples


POST /list HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/json

{
  "list": {
    "name": "My list",
    "contacts": {
      "gsm": [
        {
          "value": "33601020304",
          "info1": "Louis",
          "info2": "de Broglie",
          "info3": "1892",
          "info4": "Dieppe"
        },
        {
          "value": "33601020305",
          "info1": "Richard",
          "info2": "Feynman",
          "info3": "1918",
          "info4": "New-York"
        }
      ]
    }
  }
}
          
        

POST /list HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<list>
  <name>My list</name>
  <contacts>
    <gsm>
      <value>33601020304</value>
      <info1>Louis</info1>
      <info2>de Broglie</info2>
      <info3>1892</info3>
      <info4>Dieppe</info4>
    </gsm>
    <gsm>
      <value>33601020305</value>
      <info1>Richard</info1>
      <info2>Feynman</info2>
      <info3>1918</info3>
      <info4>New-York</info4>
    </gsm>
  </contacts>
</list>
        
      

$response = \SMSFactor\ContactList::create([
    'list' => [
      'name' => 'My list',
      'contacts' => [
        'gsm' => [
          [
            'value' => '33601020304',
            'info1' => 'Louis',
            'info2' => 'de Broglie',
            'info3' => '1892',
            'info4' => 'Dieppe'
          ],
          [
            'value' => '33601020305',
            'info1' => 'Richard',
            'info2' => 'Feynman',
            'info3' => '1918',
            'info4' => 'New-York'
          ]
        ]
      ]
    ]
]);
      
    

Format de la réponse


{
  "status": 1,
  "message": "OK",
  "contacts": 2,
  "id": "50433"     //the id of the created list
}
          
        

<response>
  <status>1</status>
  <message>OK</message>
  <contacts>2</contacts>
  <id>50433</id>
</response>