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