É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 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 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 des lots connexes sous une campagne.

• test_mode : Défini sur vrai pour tester avec le premier appel uniquement.

• batch_id : Définir 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 des notifications en temps réel et des 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ôlez si l'IA parle immédiatement ou attend.

​Étape 5 : Envoyez la requête API

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

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

Après avoir envoyé la demande de 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 la performance et les résultats de vos appels en lot grâce à l'batch_id et aux analyses de campagne fournies. Ajustez les futurs lots 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 });