Publié le September 29, 2026 |
Les listes noires et les listes de contacts peuvent désormais être entièrement gérées via l'API REST de SIP Caller. Vous pouvez les créer, les modifier et les supprimer, et ajouter ou retirer leurs numéros, directement depuis vos propres systèmes.
Jusqu'à présent, elles n'étaient disponibles que depuis la Console Web, dans Réglages. En août, les endpoints Créer et Mettre à Jour une Campagne vous ont permis d'automatiser tout le cycle de vie des campagnes, mais les listes dont dépendent ces campagnes devaient encore être tenues à jour manuellement. Cette version comble ce manque.
Les listes noires contiennent les numéros qui ne doivent jamais être appelés, comme les clients qui ont demandé à ne plus être contactés ou les numéros signalés par votre équipe conformité. Chaque campagne peut faire référence à une ou plusieurs listes noires.
Les nouveaux endpoints vous permettent de :
Par exemple, ajouter un numéro à une liste noire dès qu'un client demande à ne plus être contacté ne nécessite qu'une seule requête :
curl -i \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer API_KEY_TOKEN' \ --request POST \ --data-raw '[{"number":"+18005551234","description":"Does not want to be called"}]' \ 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers'
Les listes de contacts sont des listes réutilisables de numéros à appeler. Chaque numéro peut avoir ses propres valeurs de variables, comme le nom du client, un solde dû ou une date de rendez-vous, que vous pouvez utiliser pour diffuser des messages personnalisés à chaque appel. Les listes de contacts nécessitent l'Édition Professional ou Enterprise.
Les mêmes opérations sont disponibles pour les listes de contacts :
varNames)Voici comment ajouter un numéro avec le nom du client et son solde dû :
curl -i \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer API_KEY_TOKEN' \ --request POST \ --data-raw '[{"number":"+18005551239","varValues":["Peter Jackson","$367.75"]}]' \ 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers?varNames=["Customer Name","Due Balance"]'
Les valeurs de varValues suivent le même ordre que les noms de variables indiqués dans varNames.
Une liste de contacts n'est utile qu'une fois ses numéros intégrés à une campagne. Un nouvel endpoint fait la même chose que l'option Ajouter des numéros depuis une liste de contacts existante de la console : il copie tous les numéros d'une liste de contacts, avec leurs valeurs de variables, dans une campagne en une seule requête.
curl -i \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer API_KEY_TOKEN' \ --request POST \ --data-raw '{"contactListId":"CONTACT_LIST_ID"}' \ 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers/copyFromContactList'
La réponse indique combien de numéros contenait la liste de contacts, combien ont été ajoutés à la campagne et combien ont été ignorés car en double :
{ "totalNumbers": 2000, "numbersAdded": 2000, "numbersSkipped": 0 }
Cet endpoint suit les mêmes règles que les autres méthodes d'ajout de numéros via l'API :
Draft. Les campagnes dynamiques peuvent continuer à en recevoir une fois à l'état Active ou Paused.Draft, un même numéro avec les mêmes valeurs de variables n'est ajouté qu'une seule fois. Un même numéro avec des valeurs de variables différentes est bien ajouté, car il est considéré comme porteur d'un message différent.Active ou Paused, les doublons sont autorisés. Ces campagnes sont souvent de longue durée, donc un numéro répété est traité comme un nouvel appel, par exemple pour recontacter le même client.Fini d'exporter une liste simplement pour la téléverser à nouveau sous forme de fichier CSV. Tenez votre liste de contacts à jour une seule fois, et chargez-la dans autant de campagnes que nécessaire.
| Opération | Listes Noires | Listes de Contacts |
|---|---|---|
| Lister | GET /blackLists | GET /contactLists |
| Créer | POST /blackLists | POST /contactLists |
| Modifier | PUT /blackLists/{id} | PUT /contactLists/{id} |
| Supprimer | DELETE /blackLists | DELETE /contactLists |
| Lister les numéros | GET /blackLists/{id}/numbers | GET /contactLists/{id}/numbers |
| Ajouter des numéros | POST /blackLists/{id}/numbers | POST /contactLists/{id}/numbers |
| Supprimer des numéros | DELETE /blackLists/{id}/numbers | DELETE /contactLists/{id}/numbers |
| Ajouter à une campagne | — | POST /campaigns/{id}/numbers/copyFromContactList |
Tous les chemins sont relatifs à https://api.sipcaller.com/v1/accounts/ACCOUNT_ID.
Les requêtes de modification doivent inclure un champ lastUpdatedAt contenant la valeur updatedAt renvoyée la dernière fois que vous avez récupéré, créé ou modifié la liste. Cela évite qu'un processus écrase sans prévenir les modifications faites par un autre, par exemple lorsqu'un membre de l'équipe renomme une liste dans la console pendant qu'une intégration la met à jour.
Grâce à ces endpoints, les listes qui alimentent vos campagnes peuvent rester synchronisées avec les systèmes où se trouvent réellement vos données :
Une équipe de recouvrement exécute chaque nuit une tâche qui :
blackListIds.copyFromContactList.Chaque étape, des listes jusqu'aux appels, passe désormais par l'API, sans aucune étape manuelle dans la console.
La documentation de l'API couvre désormais tous les nouveaux endpoints de Listes Noires et de Listes de Contacts, y compris l'ajout de numéros d'une liste de contacts à une campagne, avec des exemples complets de requête et de réponse pour chacun.
👉 Connectez-vous à votre console SIP Caller et essayez les nouvelles méthodes de l'API.
👉 Besoin d'aide pour l'intégration ? Contactez notre équipe — nous serons ravis de vous accompagner.