/customers-custom-events/{id} (POST)

Cette méthode permet de créer un nouvel évènement personnalisé dans la timeline d'un profil.

Endpoint : social-sb.com/api/v2/customers-custom-events/{id}

Verb : POST

Paramètres obligatoires

id : identifiant SPREAD du profil (dans l'URL)

type : Type d'évènement (`comment`, `message`, ...)

metadata : Liste de méta-données (à définir en fonction du type d'évènement)

Paramètres complémentaires :

date : Date complète GMT de l'évènement (format: Y-m-d H:i:s)

Exemple d'appel PHP :

<?php
$curl_post_data = [
    "customerCustomEvent" => [
        "type" => "message",
        "date" => date("Y-m-d H:i:s"),
        "metadata" => [
            "subject" => "Mon message",
            "text" => "Ceci est un message transmis par l'API !"
        ]
    ]
];
  
$curl_post_data = json_encode($curl_post_data);
  
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://social-sb.com/api/v2/customers-custom-events/123456");
curl_setopt($curl, CURLOPT_POSTREDIR, CURL_REDIR_POST_ALL);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
// Auth avec la clé publique et la clé privée (voir dans Paramétrage > Tracker)
curl_setopt($curl, CURLOPT_USERPWD, "clef_public:clef_privee");
curl_setopt($curl, CURLOPT_POSTFIELDS, $curl_post_data );
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_VERBOSE, 1);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$curl_return = curl_exec($curl);
var_dump($curl_return);
curl_close($curl);

Réponse :

{
    "customerCustomEvent": {
        "id": 42,
        "type": "message",
        "metadata": {
            "subject": "Mon message",
            "text": "Ceci est un message transmis par l'API !"
        },
        "date": "2019-05-11 12:00:00",
        "createdAt": "2019-05-11 12:00:00",
        "updatedAt": null
    }
}

/customers-custom-events/{id} (GET)

Cette méthode permet de récupérer les évènements personnalisés d'un profil.

Endpoint: social-sb.com/api/v2/customers-custom-events/{id}

Verb: GET

Paramètres obligatoires :

id : identifiant SPREAD du profil

Paramètres complémentaires :

Aucun

Réponse :

{
    "customerCustomEvents": [
        {
            "type": "message",
            "metadata": {
                "subject": "Message subject",
                "text": "This is my message"
            },
            "date": "2019-06-05 11:38:00",
            "createdAt": "2019-06-07 14:23:27",
            "updatedAt": null
        },
        {
            "type": "comment",
            "metadata": {
                "text": "Called us for product informations"
            },
            "date": "2019-06-05 09:42:49",
            "createdAt": "2019-06-05 09:45:08",
            "updatedAt": "2019-06-07 14:16:20"
        }
    ],
    "count": 2,
    "nextPageUrl": "https://social-sb.com/api/v2/customers?startAt=2"
}

Exemple d'appel PHP :

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://social-sb.com/api/v2/customers-custom-events/123456");
// Auth avec la clé publique et la clé privée (voir dans Paramétrage > Tracker)
curl_setopt($curl, CURLOPT_USERPWD, "clef_public:clef_privee");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$curl_return = curl_exec($curl);
var_dump($curl_return);
curl_close($curl);

🆘

Si vous avez d’autres questions sur ce sujet, vous pouvez contacter le support. 💬