Étape 1 : Configurez votre autorisation

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

​Étape 2 : Créez l'invite de base

Rédigez une invite de base qui sera commune à tous les appels du 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éfinir 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 invite 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 connexes 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 que l'IA doit connaître pendant 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 arbres téléphoniques ou laisser des messages vocaux.

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

​Étape 5 : Envoyez la demande API

Utilisez le snippet de code JavaScript ou Python fourni pour faire la demande API.

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

Après l'envoi de la demande en lot, vous recevrez une réponse avec un message et le batch_id. Surveillez la progression de vos appels et toute réponse via votre webhook spécifié.

Voici à quoi pourrait ressembler un exemple de réponse :

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

​Étape 7 : Suivi et analyse

Suivez la performance et les résultats de vos appels en lot via le batch_id fourni et les analyses de campagne. Ajustez les futurs lots en fonction des insights obtenus.

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