Les appels de rappel sont des appels demandés par un utilisateur final. Avec l'API d'appel de rappel, vous pouvez planifier des appels de rappel de manière programmatique et annuler des appels planifiés. Grâce à ces fonctionnalités, vous pouvez créer des applications permettant aux utilisateurs finaux de demander des appels de rappel à partir d'une file d'attente que vous spécifiez. Les utilisateurs finaux peuvent également annuler les appels qu'ils ont planifiés précédemment. Pour en savoir plus sur l'authentification avec l'API d'appel de rappel, consultez la section Authentification de base.
Utiliser l'API d'appel de rappel
Vous pouvez utiliser l'API d'appel de rappel pour planifier des appels de rappel et annuler des appels planifiés.
Planifier un appel
Pour planifier un appel, appelez POST https://<subdomain>.<domain>/apps/api/v1/calls
et incluez un corps de requête semblable à celui-ci :
{
"call_type": "ScheduledCall",
"menu_id": 12345,
"end_user_number": "+18005550100",
"scheduled_at": "2025-09-02T14:30:00Z"
}
Une requête réussie renvoie un objet d'appel, y compris l'ID de l'appel.
Annuler un appel planifié
Pour annuler un appel planifié, appelez PATCH
https://<subdomain>.<domain>/apps/api/v1/calls/scheduled/{id}/cancel. Spécifiez l'ID de l'appel que vous souhaitez annuler.
Une requête réussie renvoie des informations sur l'appel annulé.
Annuler plusieurs appels planifiés
Pour annuler plusieurs appels planifiés, appelez PATCH
https://<subdomain>.<domain>/apps/api/v1/calls/scheduled/cancel. Incluez un corps de requête contenant un tableau call_ids des ID d'appel à annuler.
Consultez l'exemple de code suivant :
{
"call_ids": [123, 456, 789]
}
Une requête réussie renvoie une réponse avec un en-tête de réponse contenant une URL Location permettant de vérifier l'état de l'annulation.
Utiliser des appels de rappel avec des CRM
Vous pouvez utiliser l'API d'appel de rappel avec les intégrations CRM Salesforce, Zendesk et ServiceNow.
Comportement général des rappels
Si vous utilisez un CRM compatible (Salesforce, Zendesk ou ServiceNow), les conditions suivantes affectent le comportement des rappels planifiés :
Un enregistrement est ouvert et comporte déjà un appel planifié actif : si une recherche d'ID de ticket indique que l'enregistrement est ouvert et comporte déjà un appel planifié actif, l'appel n'est pas planifié. Le commentaire suivant est associé à l'enregistrement CRM :
A scheduled call was not created because the record already has an active scheduled call.Le CRM est inaccessible : si une recherche d'ID de ticket indique que le CRM est inaccessible, l'appel est annulé. Le commentaire suivant est associé à l'enregistrement CRM :
A scheduled call was canceled because the CRM was unreachable.
Comportement des rappels avec des enregistrements fermés
La façon dont les appels de rappel sont gérés pour les enregistrements fermés varie en fonction du CRM que vous utilisez :
Utilisateurs de Zendesk et de ServiceNow : si une recherche d'ID de ticket indique que l' enregistrement est fermé, l'appel n'est pas planifié. Le commentaire suivant est associé à l'enregistrement CRM :
A scheduled call was not created because the record is closed.Utilisateurs de Salesforce : consultez la section Appels de rappel avec Salesforce pour configurer la façon dont votre instance gère les appels planifiés pour les enregistrements fermés.
Appels de rappel avec Salesforce
Si vous avez intégré CCAI Platform à Salesforce, vous pouvez configurer la façon dont votre instance gère les appels planifiés pour les enregistrements fermés. Voici les options de configuration pour les intégrations Salesforce :
Vérifier l'état de l'enregistrement et rouvrir les enregistrements fermés.
Vérifier l'état de l'enregistrement et annuler les appels planifiés pour les enregistrements fermés.
Ne pas vérifier l'état de l'enregistrement
Vous pouvez configurer CCAI Platform pour qu'il ne vérifie pas l'état de l'enregistrement avant de passer un appel planifié. Avec cette configuration, l'appel est passé comme prévu, que l'enregistrement soit ouvert ou fermé.
Pour configurer CCAI Platform afin qu'il ne vérifie pas l'état de l'enregistrement, procédez comme suit :
Dans le portail CCAI Platform, cliquez sur Settings > Operation Management (Paramètres > Gestion des opérations). Si le menu Settings (Paramètres) ne s'affiche pas, cliquez sur Menu.
Accédez à CRM Record Creation Details > Closed record options when initiating an API-scheduled call (Détails de la création d'enregistrement CRM > Options d'enregistrement fermé lors du lancement d'un appel planifié par l'API).
Sélectionnez Don't check the record status. Always initiate the API-scheduled call (Ne pas vérifier l'état de l'enregistrement. Toujours lancer l'appel planifié par l'API).
Cliquez sur Save General (Enregistrer les paramètres généraux).
Vérifier l'état de l'enregistrement et rouvrir les enregistrements fermés
Vous pouvez configurer CCAI Platform pour qu'il vérifie l'état de l'enregistrement avant de passer un appel planifié et rouvre les enregistrements fermés. Avec cette configuration, si l'état de l'enregistrement est "Fermé", les actions suivantes sont effectuées :
L'appel est passé comme prévu.
L'enregistrement est rouvert.
Le commentaire suivant est associé à l'enregistrement CRM :
The record was reopened at the time of a scheduled call.
Pour configurer CCAI Platform afin qu'il vérifie l'état de l'enregistrement et rouvre les enregistrements fermés, procédez comme suit :
Dans le portail CCAI Platform, cliquez sur Settings > Operation Management (Paramètres > Gestion des opérations). Si le menu Settings (Paramètres) ne s'affiche pas, cliquez sur Menu.
Accédez à CRM Record Creation Details > Closed record options when initiating an API-scheduled call (Détails de la création d'enregistrement CRM > Options d'enregistrement fermé lors du lancement d'un appel planifié par l'API).
Sélectionnez Check the record status. If the record is closed > Reopen the record (Vérifier l'état de l'enregistrement. Si l'enregistrement est fermé > Rouvrir l'enregistrement).
Cliquez sur Save General (Enregistrer les paramètres généraux).
Vérifier l'état de l'enregistrement et annuler les appels planifiés pour les enregistrements fermés
Vous pouvez configurer CCAI Platform pour qu'il vérifie l'état de l'enregistrement avant de passer un appel planifié et annule les appels planifiés pour les enregistrements fermés. Avec cette configuration, si l'état de l'enregistrement est "Fermé", les actions suivantes sont effectuées :
L'appel planifié est annulé.
Le commentaire suivant est associé à l'enregistrement CRM :
A scheduled call was canceled because the record is closed.
Pour configurer CCAI Platform afin qu'il vérifie l'état de l'enregistrement et annule les appels planifiés pour les enregistrements fermés, procédez comme suit :
Dans le portail CCAI Platform, cliquez sur Settings > Operation Management (Paramètres > Gestion des opérations). Si le menu Settings (Paramètres) ne s'affiche pas, cliquez sur Menu.
Accédez à CRM Record Creation Details > Closed record options when initiating an API-scheduled call (Détails de la création d'enregistrement CRM > Options d'enregistrement fermé lors du lancement d'un appel planifié par l'API).
Sélectionnez Check the record status. If the record is closed > Cancel the scheduled call (Vérifier l'état de l'enregistrement. Si l'enregistrement est fermé > Annuler l'appel planifié).
Cliquez sur Save General (Enregistrer les paramètres généraux).