Vous pouvez modifier le statut d'un contact dans ActiveTrail par l'API de deux façons. La requête POST est la plus simple, car vous n'avez pas besoin d'obtenir d'abord l'ID du contact.

  1. Avec une requête POST (le plus simple) :

    Envoyez une requête POST avec l'e-mail du contact pour mettre à jour le contact directement, y compris son statut (n'importe quel statut, par exemple repasser un contact désinscrit à « Actif »). Le point de terminaison exige un e-mail (paramètre obligatoire). Pour un contact qui n'a qu'un numéro de mobile (SMS), utilisez les requêtes GET et PUT ci-dessous.

    À noter : envoyer subscriptionStatus avec la valeur false par l'API ne crée pas un contact désinscrit.

    Point de terminaison : https://webapi.mymarketing.co.il/api/docs/User/Api/POST-api-contacts

  2. Avec des requêtes GET et PUT :

    a. Envoyez une requête GET pour récupérer tous les contacts (vous pouvez utiliser le paramètre SEARCH TERM pour récupérer un contact précis sans les récupérer tous, mais si l'e-mail du contact contient un signe plus, il ne sera pas trouvé).

    Point de terminaison : https://webapi.mymarketing.co.il/api/docs/User/Api/GET-api-contacts_CustomerStates_SearchTerm_FromDate_ToDate_Page_Limit

    b. Trouvez l'ID associé à l'e-mail ou au SMS du contact, puis modifiez le statut avec une requête PUT.

    Point de terminaison : https://webapi.mymarketing.co.il/api/docs/User/Api/PUT-api-contacts-id

    Dans la requête PUT, indiquez l'ID du contact et le statut voulu.

    À noter : dans la requête GET, les dates de l'URL correspondent à la date du dernier changement de statut du contact. Sans dates, vous recevez les contacts dont le statut a changé au cours des 3 derniers mois. Indiquez comme from_date la date à laquelle vous avez commencé à utiliser ActiveTrail, et comme to_date la date de demain (une date dynamique).