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": "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'
          ]
        ]
      ]
    ]
]);
      
    

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>