Étape 1 : Configurez votre autorisation

Pour lancer un appel par lot (batch call), vous devez d'abord authentifier votre requête. Assurez-vous d'avoir obtenu votre clé API lors de votre inscription sur le portail développeur.

​Étape 2 : Créez le prompt de base

Rédigez un prompt de base qui sera commun à tous les appels du lot. Utilisez des balises {{accolades}} pour le contenu dynamique.

Exemple :

"You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}.";

"You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}.";

"You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}.";

​Étape 3 : Définissez les données d'appel

Spécifiez la liste des appels dans le tableau call_data. Chaque appel doit comporter un phone_number et peut inclure d'autres propriétés correspondant aux balises de votre prompt de base.

Exemple :

[
  {
    phone_number: "1234567890",
    business: "ABC co.",
    service: "Netflix",
    date: "September 4th",
  },
  {
    phone_number: "32176540987",
    business: "XYZ inc.",
    service: "Window Cleaning",
    date: "December 20th",
  },
];

[
  {
    phone_number: "1234567890",
    business: "ABC co.",
    service: "Netflix",
    date: "September 4th",
  },
  {
    phone_number: "32176540987",
    business: "XYZ inc.",
    service: "Window Cleaning",
    date: "December 20th",
  },
];

[
  {
    phone_number: "1234567890",
    business: "ABC co.",
    service: "Netflix",
    date: "September 4th",
  },
  {
    phone_number: "32176540987",
    business: "XYZ inc.",
    service: "Window Cleaning",
    date: "December 20th",
  },
];

​Étape 4 : Configuration supplémentaire

• label : Attribuez un libellé à votre lot pour faciliter son suivi.

• campaign_id : Regroupez les lots associés au sein d'une même campagne.

• test_mode : Définissez sur true pour effectuer un test uniquement avec le premier appel.

• batch_id : À renseigner manuellement ou généré automatiquement pour le suivi.

• Paramètres de voix et de langue : Sélectionnez voice_id, reduce_latency et language.

• request_data : Incluez des faits précis que l'IA doit connaître durant l'appel.

• webook : Pour recevoir des notifications et les transcriptions en temps réel après l'appel.

• max_duration : Définissez la durée maximale de chaque appel.

• amd : Activez cette option pour naviguer dans les serveurs vocaux interactifs (SVI) ou laisser des messages vocaux.

• wait_for_greeting : Déterminez si l'IA s'exprime immédiatement ou attend une salutation.

​Étape 5 : Envoyez la requête API

Utilisez l'extrait de code JavaScript ou Python fourni pour exécuter la requête API.

​Étape 6 : Traitez la réponse

Après l'envoi de la requête par lot, vous recevrez une réponse contenant un message et le batch_id. Suivez la progression de vos appels et l'ensemble des réponses via le webhook configuré.

Voici un exemple de réponse possible :

{
  "message": "success",
  "batch_id": "3p$7rQ3p9sT5bzmF-gen-batch"
}

{
  "message": "success",
  "batch_id": "3p$7rQ3p9sT5bzmF-gen-batch"
}

{
  "message": "success",
  "batch_id": "3p$7rQ3p9sT5bzmF-gen-batch"
}

​Étape 7 : Suivi et analyses

Suivez les performances et les résultats de vos appels par lot à l'aide du batch_id fourni et des analyses de campagne. Ajustez vos futurs lots en fonction des enseignements tirés.

// Headers
const headers = {
  authorization: "YOUR-API-KEY-HERE",
};

// Data
const data = {
  base_prompt:
    "You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}.",
  call_data: [
    {
      phone_number: "1234567890",
      business: "ABC co.",
      service: "Netflix",
      date: "September 4th",
    },
    {
      phone_number: "32176540987",
      business: "XYZ inc.",
      service: "Window Cleaning",
      date: "December 20th",
    },
  ],
  label: "Renewal Reminder - Wednesday Afternoon with female voice",
  voice_id: 0,
  max_duration: 10,
  reduce_latency: true,
  wait_for_greeting: true,
};

// API request
await axios.post("https://api.bland.ai/v1/batches", data, { headers });

// Headers
const headers = {
  authorization: "YOUR-API-KEY-HERE",
};

// Data
const data = {
  base_prompt:
    "You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}.",
  call_data: [
    {
      phone_number: "1234567890",
      business: "ABC co.",
      service: "Netflix",
      date: "September 4th",
    },
    {
      phone_number: "32176540987",
      business: "XYZ inc.",
      service: "Window Cleaning",
      date: "December 20th",
    },
  ],
  label: "Renewal Reminder - Wednesday Afternoon with female voice",
  voice_id: 0,
  max_duration: 10,
  reduce_latency: true,
  wait_for_greeting: true,
};

// API request
await axios.post("https://api.bland.ai/v1/batches", data, { headers });

// Headers
const headers = {
  authorization: "YOUR-API-KEY-HERE",
};

// Data
const data = {
  base_prompt:
    "You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}.",
  call_data: [
    {
      phone_number: "1234567890",
      business: "ABC co.",
      service: "Netflix",
      date: "September 4th",
    },
    {
      phone_number: "32176540987",
      business: "XYZ inc.",
      service: "Window Cleaning",
      date: "December 20th",
    },
  ],
  label: "Renewal Reminder - Wednesday Afternoon with female voice",
  voice_id: 0,
  max_duration: 10,
  reduce_latency: true,
  wait_for_greeting: true,
};

// API request
await axios.post("https://api.bland.ai/v1/batches", data, { headers });