Crea lista

Questo metodo ti permette di creare una lista di contatti. Ogni contatto può avere fino a 4 informazioni personalizzate. Queste informazioni potranno poi apparire in ogni messaggio. Per esempio, se inserisci [info1] nel messaggio, poi verrà sostituito in automatico dall’informazione del contatto corrispondente.

POST

/list

Parametri del body

value richiesto	The recipient's number in E.164 format
name	Il nome della lista. Se non fornisci alcun nome, il nome di default sarà la data di creazione
info1	Information 1
info2	Information 2
info3	Information 3
info4	Information 4

Esempi


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

{
  "list": {
    "name": "My list",
    "contacts": {
      "gsm": [
        {
          "value": "33612345678",
          "info1": "Louis",
          "info2": "de Broglie",
          "info3": "1892",
          "info4": "Dieppe"
        },
        {
          "value": "33612345677",
          "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>33612345678</value>
      <info1>Louis</info1>
      <info2>de Broglie</info2>
      <info3>1892</info3>
      <info4>Dieppe</info4>
    </gsm>
    <gsm>
      <value>33612345677</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' => '33612345678',
            'info1' => 'Louis',
            'info2' => 'de Broglie',
            'info3' => '1892',
            'info4' => 'Dieppe'
          ],
          [
            'value' => '33612345677',
            'info1' => 'Richard',
            'info2' => 'Feynman',
            'info3' => '1918',
            'info4' => 'New-York'
          ]
        ]
      ]
    ]
]);

Formato della risposta


{
  "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>