https://retellai.com/?utm_source=discord&utm_medium=seo logo
batch call comment on automatise
# ❓・ai-evy-support
t
@AI Evy batch call comment on automatise
a
Thanks for tagging me @ts8466. I'll look through relevant sources and get back to you shortly.
ring multiple recipients to be contacted. [(2) ]()
​ To learn more, see the sources I considered: [[1] Batch Calling, New Docs, and More Improvements!](https://www.retellai.com/changelog/batch-calling-new-docs-and-more-improvements) [[2] Create Batch calls](https://docs.retellai.com/deploy/make-batch-call) [[3] Streamline Calls with Retell AI’s Batch Dialer | Retell AI](https://www.retellai.com/blog/boost-operation-efficiency-with-retell-ais-batch-calling) ​
### Answer Retell AI's Batch Calling feature provides several automation capabilities: [(1) ]() [(2) ]() [(3) ]() Automated Dispatch Options: - **Send Now**: Dispatch all calls immediately [(1) ]() [(3) ]() - **Scheduled Time**: Send out calls at a scheduled time Automation Features: - Batch Calling queues your calls without hitting concurrency limits, ensuring a seamless experience [(1) ]() - You can make multiple calls simultaneously by simply uploading an Excel sheet - The system enables you to efficiently manage multiple calls by organizing them into groups [(2) ]() Setup Process: 1. Prepare your recipient list in CSV format with a header row including a "phone number" column 2. For dynamic variables, add additional columns in the CSV with custom data for each recipient (e.g., a column header
first_name
can be referenced as
{{first_name}}
) 3. Configure the time window to define batch call time windows 4. Choose between "Send Now" to start calls immediately or "Schedule" for a future time Pricing: $0.005 per dial (20k calls for $100) [(1) ]() [(3) ]() The automation streamlines communication workflows and is particularly useful for campaigns, updates, or any situation requi
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
@AI Evy si je veux automatiser avec n8n que mon client envoie un csv sur n8n qui envoie directement a retell et lance le batch c possible ?
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
### Answer Oui, c'est possible d'automatiser la création de batch calls avec n8n en utilisant l'API Retell AI [(1) ]() . Voici comment procéder : Vous pouvez utiliser l'API Create Batch Call pour lancer un batch call programmatiquement . Votre workflow n8n devrait : 1. Recevoir le fichier CSV de votre client 2. Parser le CSV pour extraire les numéros de téléphone et variables dynamiques 3. Appeler l'API Retell AI pour créer le batch call Exemple de code pour l'appel API :
Copy code
javascript
import Retell from 'retell-sdk';
const client = new Retell({
 apiKey: 'YOUR_RETELL_API_KEY',
}) ;
const batchCallResponse = await client.batchCall.createBatchCall({
 from_number: '+14157774444',
 tasks: [{ to_number: '+12137774445' }],
}) ;
console.log(batchCallResponse.batch_call_id) ;
Points importants : - Les numéros doivent être au format E.164 (ex: +14157774444) - Vous pouvez inclure des variables dynamiques dans chaque tâche - Vous pouvez définir
trigger_timestamp
pour planifier l'envoi ou omettre ce paramètre pour un envoi immédiat - Le coût est de $0.005 par appel [(2) ]() [(3) ]() La documentation officielle de l'API Create Batch Call fournit tous les détails nécessaires pour l'intégration [(1) ]() .
​ To learn more, see the sources I considered: [[1] Create Batch Call](https://docs.retellai.com/api-references/create-batch-call) [[2] Streamline Calls with Retell AI’s Batch Dialer | Retell AI](https://www.retellai.com/blog/boost-operation-efficiency-with-retell-ais-batch-calling) [[3] Batch Calling, New Docs, and More Improvements!](https://www.retellai.com/changelog/batch-calling-new-docs-and-more-improvements) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
@AI Evy si je veux faire l'automatisation via n8n tu saurais m'expliquer comment faire ?
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
### Answer --- Pour automatiser l'envoi de batch calls via n8n avec Retell AI, voici les étapes à suivre [(1) ]() : Configuration dans n8n : 1. Réception du CSV : Utilisez un trigger n8n (webhook, email, Google Drive, etc.) pour recevoir le fichier CSV de votre client 2. Parsing du CSV : Ajoutez un node "Spreadsheet File" ou "CSV" pour extraire les données (numéros de téléphone et variables dynamiques) 3. Appel API Retell : Utilisez un node "HTTP Request" pour appeler l'API Create Batch Call de Retell AI Configuration du node HTTP Request : - Method : POST - URL : ` - Authentication : Header - Header Name :
Authorization
- Header Value :
Bearer YOUR_RETELL_API_KEY
- Body : JSON avec la structure suivante :
Copy code
json { "from_number": "+14157774444", "tasks": [ { "to_number": "+12137774445" } ] }
Points importants : - Le
from_number
doit être un numéro acheté ou importé dans Retell au format E.164 - Pour chaque ligne du CSV, créez une tâche dans le tableau
tasks
- Vous pouvez ajouter
trigger_timestamp
(en millisecondes Unix) pour planifier l'envoi, sinon les appels partent immédiatement - Pour des variables dynamiques personnalisées, ajoutez-les dans chaque objet task du tableau Conseil : Assurez-vous que vos numéros de téléphone dans le CSV sont au bon format avant l'envoi [(2) ]() . Les problèmes de formatage sont une cause fréquente d'erreurs . Le coût est de $0.005 par appel [(3) ]() .
​ To learn more, see the sources I considered: [[1] Create Batch Call](https://docs.retellai.com/api-references/create-batch-call) [[2] Outbound calls/batch calling not working](https://discord.com/channels/1186424376300679209/1359296605748199616) [[3] Streamline Calls with Retell AI’s Batch Dialer | Retell AI](https://www.retellai.com/blog/boost-operation-efficiency-with-retell-ais-batch-calling) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
Hello @AI Evy , i have createv a payload like : [ { "from_number": "+33423565435", "tasks": [ { "to_number": "+33612345678", "retell_llm_dynamic_variables": { "phone": "33612345678", "prenom": "jean", "nom": "dupont", "first_name": "jean", "last_name": "dupont", "full_name": "jean dupont" } } ] } ] , the batch is running but no call started . I share you the output after the http request : [ { "batch_call_id": "batch_call_860990119445702324898cb3", "name": "", "from_number": "+33423565435", "status": "planned", "timezone": "America/Los_Angeles", "send_now": true, "scheduled_timestamp": 1775936837776, "total": 1, "total_task_count": 1, "sent": 0, "picked_up": 0, "completed": 0, "tasks_url": "https://retell-utils-public.s3.us-west-2.amazonaws.com/batch_call_860990119445759598cb3/tasks.json" } ] do you know what is the pb ?
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
rt-phone-number) - Monitor the batch call status - if it remains "planned" without progressing, contact support Correct payload structure:
### Answer Looking at your batch call response, the status is "planned" with
send_now: true
, but
scheduled_timestamp
is set to a future time (1775936837776 milliseconds = April 11, 2026) [(1) ]() . This creates a conflict. Potential issues: 1. **Phone number permissions**: Your
from_number
(+33423565435 in the response, though you sent +33423500621) must be a number purchased from Retell or imported to Retell . If this French number isn't properly configured in your account, calls won't initiate [(2) ]() . 2. **International calling**: France (+33) may require specific permissions. International calling is supported for 14 countries, but you need to verify France is enabled for your account [(3) ]() . 3. **Scheduled timestamp conflict**: The
scheduled_timestamp
field represents a Unix timestamp in milliseconds for when to send the batch call [(1) ]() . If you want immediate execution with
send_now
, you should omit
trigger_timestamp
in your request . 4. **Recent platform issues**: There was a reported incident where scheduled batch calls didn't run from 2:35 PM to 5:15 PM PST on January 27 [(4) ]() . Additionally, other users have reported batch calls going to "ONGOING" status but never dialing [(5) ]() . Recommended fixes: - Verify your French number is properly imported and has outbound permissions enabled - Remove
trigger_timestamp
from your payload if you want immediate execution - Check that France is in your allowed outbound country list [(2) ](
Copy code
javascript
{
  "from_number": "+33423500621",
  "tasks": [
    {
      "to_number": "+33612345678",
      "retell_llm_dynamic_variables": {
        "prenom": "jean",
        "nom": "dupont"
      }
    }
  ]
}
[(1) ]()
​ To learn more, see the sources I considered: [[1] Create Batch Call](https://docs.retellai.com/api-references/create-batch-call) [[2] Import Phone Number](https://docs.retellai.com/api-references/import-phone-number) [[3] Platform Changelogs | Retell AI](https://www.retellai.com/changelog) [[4] Scheduled batch calls not running](https://community.retellai.com/t/scheduled-batch-calls-not-running/731) [[5] Batch Calls Not Dialing](https://discord.com/channels/1186424376300679209/1474098908815949825) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
@AI Evy but iit is automitic timestamp, it is a output of the http request, i dont send it..
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
### Answer You're correct that
scheduled_timestamp
is an output field from the API response, not something you send. [(1) ]() The real issue is likely your phone number configuration: Your
from_number
(+33423565435) must be: - A number purchased from Retell or imported to Retell - Properly bound to an agent to enable batch calls [(2) ]() Key troubleshooting steps: 1. **Verify number binding**: Ensure the number is bound to agents to enable batch calls 2. **Check concurrency**: With a concurrency limit of 20, Retell automatically queues batch calls and starts a new call whenever one ends, keeping max 20 active calls at a time until all leads are completed [(3) ]() 3. **Monitor batch status**: Currently, there is no API to pull batch calling status data (success count, failed count, remaining calls) [(4) ]() - you'll need to monitor through the dashboard 4. **Time window configuration**: If you configured a call time window when creating the batch, calls will only execute during those allowed hours and days [(1) ]() [(2) ]() Your payload looks correct - the issue is most likely that your French number isn't properly configured in your Retell account for outbound batch calling. Verify in your dashboard that this number is imported and bound to an agent.
​ To learn more, see the sources I considered: [[1] Create Batch Call](https://docs.retellai.com/api-references/create-batch-call) [[2] Create Batch calls](https://docs.retellai.com/deploy/make-batch-call) [[3] Discord message from @immaculate_cheetah_77268 on 2026-02-13](https://discord.com/channels/1186424376300679209/1186462578310910112/1471807387206942774) [[4] Batch Calling Status API](https://discord.com/channels/1186424376300679209/1356946621962911795) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
@AI Evy i have number to call in france in retell, the output is like that: [ { "batch_call_id": "batch_call_1e3412e2e73a09b4296cd", "name": "", "from_number": "+33423500621", "status": "planned", "timezone": "America/Los_Angeles", "send_now": true, "scheduled_timestamp": 1775939465107, "total": 1, "total_task_count": 1, "sent": 0, "picked_up": 0, "completed": 0, "tasks_url": "https://retell-utils-public.s3.us-west-2.amazonaws.com/batch_call_1e3412e2e73a09b4296cd/tasks.json" } ] so no task.... why ?
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
### Answer The output shows
"total_task_count": 1
and
"sent": 0
, which means your batch call was created successfully but hasn't started executing yet. [(1) ]() The issue is the scheduled timestamp: Your response shows
"scheduled_timestamp": 1775939465107
(April 11, 2026 at approximately 7:24 PM PST) with
"send_now": true
. Even though you set
send_now: true
, the system scheduled it for a future time based on your timezone setting (
"timezone": "America/Los_Angeles"
) . Why tasks show 0 sent: From Saturday, April 11, 2026 (the current date) , the scheduled timestamp of 1775939465107 milliseconds converts to April 11, 2026 at 7:24 PM PST - which is in the future. The batch is in "planned" status waiting for that time to arrive before executing. Solutions: 1. **Wait for execution time**: The batch will automatically start when the scheduled time arrives (7:24 PM PST) 2. **Check call time windows**: If you configured a
call_time_window
when creating the batch, calls will only execute during those allowed hours and days [(1) ]() [(2) ]() 3. **Verify number configuration**: Ensure your
from_number
(+33423500621) is bound to an agent in your dashboard to enable batch calls [(2) ]() 4. **Monitor in dashboard**: Navigate to the Batch Call tab to see real-time status updates The batch call was created successfully - it's just waiting for the scheduled time or allowed calling window to begin execution.
​ To learn more, see the sources I considered: [[1] Create Batch Call](https://docs.retellai.com/api-references/create-batch-call) [[2] Create Batch calls](https://docs.retellai.com/deploy/make-batch-call) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
@AI Evy take me a exemple of payload with call_time_window
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
### Answer Voici un exemple de payload avec
call_time_window
pour créer un batch call : [(1) ]()
Copy code
javascript
import Retell from 'retell-sdk';
const client = new Retell({
 apiKey: 'YOUR_RETELL_API_KEY',
}) ;
const batchCallResponse = await client.batchCall.createBatchCall({
 from_number: '+14157774444',
 tasks: [{ to_number: '+12137774445' }],
}) ;
console.log(batchCallResponse.batch_call_id) ;
Structure du
call_time_window
:
[(2) ]() [(1) ]() Le
call_time_window
définit les fenêtres horaires autorisées dans un fuseau horaire spécifique. [(1) ]() Chaque fenêtre est un intervalle semi-ouvert [startMin, endMin) en minutes depuis 00:00 heure locale. Points importants : - Les fenêtres ne peuvent pas traverser minuit (startMin < endMin doit être respecté) -
endMin = 1440
(24:00) est valide - Les fenêtres sont exprimées en minutes locales depuis minuit Exemple de réponse API avec
call_time_window
:
Copy code
json
{
 "batch_call_id": "batch_call_dbcc4412483ebfc348abb",
 "name": "First batch call",
 "from_number": "+14157774444",
 "scheduled_timestamp": 1735718400,
 "total_task_count": 123,
 "call_time_window": {
 "windows": [
 {
 "start": 540,
 "end": 1020
 }
 ],
 "timezone": "<string>",
 "day": [
 "Monday"
 ]
 }
}
Dans cet exemple, les appels sont autorisés le lundi entre 540 minutes (9:00) et 1020 minutes (17:00) depuis minuit dans le fuseau horaire spécifié.
​ To learn more, see the sources I considered: [[1] Create Batch Call](https://docs.retellai.com/api-references/create-batch-call) [[2] Create Batch calls](https://docs.retellai.com/deploy/make-batch-call) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
@AI Evy il y a pas de call_time_window dans le payload que jenvoie.. donne moi un ex pour lintegreer dans mon payload pas dans celui da la reponse. si je veux schedulle pour mnt et que cest le time zone de france
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
### Answer Voici un exemple de payload complet avec
call_time_window
pour un envoi immédiat avec le fuseau horaire français (Europe/Paris) : [(1) ]()
Copy code
json
{
  "from_number": "+33423500621",
  "tasks": [
    {
      "to_number": "+33612345678",
      "retell_llm_dynamic_variables": {
        "prenom": "jean",
        "nom": "dupont"
      }
    }
  ],
  "call_time_window": {
    "windows": [
      {
        "start": 540,
        "end": 1020
      }
    ],
    "timezone": "Europe/Paris",
    "day": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"]
  }
}
Explication du
call_time_window
:
-
windows
: Définit les plages horaires autorisées en minutes depuis minuit -
start: 540
= 9h00 (540 minutes depuis minuit) -
end: 1020
= 17h00 (1020 minutes depuis minuit) -
timezone
: Utilisez
"Europe/Paris"
pour le fuseau horaire français -
day
: Jours de la semaine autorisés (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday) Pour un envoi immédiat sans restriction horaire, omettez complètement le champ
call_time_window
de votre payload :
Copy code
json
{
  "from_number": "+33423500621",
  "tasks": [
    {
      "to_number": "+33612345678",
      "retell_llm_dynamic_variables": {
        "prenom": "jean",
        "nom": "dupont"
      }
    }
  ]
}
Si vous omettez
call_time_window
, les appels partiront immédiatement sans restriction de plage horaire.
​ To learn more, see the sources I considered: [[1] Create Batch Call](https://docs.retellai.com/api-references/create-batch-call) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.