Étape 1 : Configurez votre autorisation

Pour initier un appel par lot, vous devez d'abord authentifier votre demande. Assurez-vous d'avoir votre clé API en vous inscrivant sur le portail développeur.

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

Élaborez un prompt de base qui sera commun à tous les appels dans le lot. Utilisez des espaces réservés {{accolades}} pour le contenu dynamique.

Exemple :

"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 avoir un phone_number et peut inclure d'autres propriétés correspondant aux espaces réservés dans 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",
  },
];

​Étape 4 : Configuration supplémentaire

• label : Attribuez une étiquette à votre lot pour un suivi facile.

• campaign_id : Organisez les lots liés sous une campagne.

• test_mode : Réglez sur vrai pour tester avec le premier appel uniquement.

• batch_id : Défini 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 spécifiques pour que l'IA les connaisse lors de l'appel.

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

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

• amd : Activez pour naviguer dans les menus téléphoniques ou laisser des messages vocaux.

• wait_for_greeting : Contrôlez si l'IA parle immédiatement ou attend.

​Étape 5 : Envoyez la demande API

Utilisez le code JavaScript ou Python fourni pour effectuer la demande API.

​Étape 6 : Gérez la réponse

Après avoir envoyé la demande par lot, vous recevrez une réponse avec un message et le batch_id. Surveillez la progression de vos appels et toutes les réponses via votre webhook spécifié.

Voici à quoi pourrait ressembler une réponse d'exemple :

{
  "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 grâce au batch_id fourni et aux analyses de campagne. Adaptez les lots futurs en fonction des informations obtenues.

// 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 });