> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Campagnes > **Info** > > Voor uitgaand bellen gelden verschillende regels per land, staat en branche. De juiste beltijden en > limieten voor belpogingen hangen dus af van wie je belt en waarom. Jij bent verantwoordelijk voor > naleving van de regels voor uitgaand bellen, waaronder toestemmingen, wat de agent zegt en het > beheren van vervolgstappen, en voor het instellen van limieten die aansluiten op de regels waar je > contacten wonen. Raadpleeg de [ElevenAgents- voorwaarden](https://elevenlabs.io/agents-terms) en de [TCPA-richtlijnen](/docs/nl/eleven-agents/legal/tcpa) > voor meer informatie. ## Overzicht Campagnes voeren uitgaande communicatie uit voor je agents. Je dient een lijst met ontvangers in, waarna je campagne contact met hen opneemt via retries, callbacks, doorverwijzingen en belvensters totdat elke ontvanger een door jou bepaald eindresultaat bereikt. Campagnes vervangen batchgesprekken. ### Waarvoor zijn campagnes bedoeld Gebruik campagnes voor outreach waarvoor meer dan één gesprek nodig is: * **Op gesprekken gebaseerde follow-ups.** Een ontvanger vraagt om om 16.00 uur teruggebeld te worden, of vraagt je het nummer van een collega te proberen. Je campagne leest de gespreksanalyse en plant het juiste volgende gesprek in. * **Belvensters.** Gesprekken worden alleen geplaatst binnen de vensters die je definieert, beoordeeld in de door jou opgegeven tijdzone. De enige uitzondering is een callback op een tijdstip dat de ontvanger heeft gevraagd; die wordt op dat tijdstip gebeld. * **Begrensd doorzetten.** Mislukte en onbeantwoorde gesprekken worden volgens een schema opnieuw geprobeerd, tot aan limieten die jij bepaalt. * **Inzicht voor beheerders.** Je kunt elke ontvanger en elk gesprek zien, evenals de reden voor elke beslissing. Je kunt op elk moment pauzeren of annuleren. ## Campagnebeleid Het beleid van een campagne bepaalt hoe persistent deze is en wanneer deze mag bellen. Je stelt een standaardbeleid in voor je workspace en elke campagne maakt er bij het aanmaken een momentopname van. Als je het workspacebeleid later wijzigt, heeft dit alleen invloed op campagnes die daarna worden gemaakt. ```json { "policy": { "timezone": "America/New_York", "retry": { "retry_delay_seconds": 600, "max_short_retries": 1, "max_total_calls": 6, "max_callbacks": 2, "max_redirects": 2, "interval_placement": "start" }, "calling_periods": [ { "weekdays": [0, 1, 2, 3, 4], "intervals": [ { "start": "10:00", "end": "12:00" }, { "start": "16:00", "end": "18:00" } ] } ], "data_collection": { "callback_time": "__system_data_collection_callback_time", "redirect_phone_number": "__system_data_collection_redirect_phone_number", "stop": "__system_data_collection_do_not_call" } } } ``` ### Retrylimieten | Veld | Beschrijving | | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `retry_delay_seconds` | Wachttijd vóór een korte retry na een mislukt, onbeantwoord gesprek of voicemail. | | `max_total_calls` | Harde limiet voor pogingen per ontvanger, inclusief het eerste gesprek. Een ontvanger wordt nooit vaker dan dit aantal keer gebeld. Standaard 6, maximaal 30. | | `max_short_retries` | Aantal korte retries dat in elk belvenster is toegestaan voordat de retry naar het volgende venster gaat. | | `max_callbacks`, `max_redirects` | Limieten voor callbacks en doorverwijzingen die een ontvanger kan aanvragen. Retry- en callbackbudgetten worden per nummer opnieuw ingesteld wanneer een gesprek wordt doorverwezen. | | `max_consecutive_failures_per_number` | Optioneel. Aantal opeenvolgende mislukkingen op één nummer voordat de ontvanger naar het volgende geregistreerde nummer gaat (maximaal vijf per ontvanger), of eindigt als er geen nummer is. | | `interval_placement` | Waar een gesprek terechtkomt wanneer het naar een toekomstig venster wordt verplaatst: aan het begin van het venster, op een willekeurig tijdstip daarin, of geroteerd om tijden te vermijden waarop al een mislukking was. | ### Belvensters `calling_periods` definiëren de wekelijkse vensters waarin gesprekken mogen worden geplaatst. Weekdagen zijn genummerd van 0 tot 6, waarbij maandag 0 is. Tijden zijn lokaal in `HH:MM` in de beleids-`timezone`, en intervallen op dezelfde weekdag mogen niet overlappen. Callbacks op een exact tijdstip vormen de enige uitzondering. Wanneer een ontvanger vraagt om op een specifiek tijdstip te worden gebeld, wordt dat gesprek op dat tijdstip gevoerd, zelfs als het buiten je vensters valt. Houd hier rekening mee bij het instellen van max_callbacks. Een beleid heeft één `timezone`. Als je contacten zich in meerdere tijdzones bevinden, maak dan voor elke zone een aparte campagne, met een eigen `timezone` en belvensters, zodat elk gesprek binnen de toegestane uren plaatsvindt waar de ontvanger woont. ### Dynamische variabelentoewijzing Campagnes koppelen de standaarditems voor gegevensverzameling met één klik aan je agent, waardoor callbacks, doorverwijzingen en het stoppen met bellen mogelijk worden. Je kunt ook aanvullende analyseresultaten toewijzen aan [dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables) voor follow-upgesprekken, zodat een retry of callback kan beginnen met wat in het vorige gesprek is geleerd. ### Context voor follow-ups Verwijs in de prompt van je agent naar deze variabelen om callbacks doorlopend te laten aanvoelen. | Variabele | Bevat | | ------------------------------------ | ------------------------------------------------------------------------ | | `campaign__call_type` | Of het gesprek een eerste contact, retry, callback of doorverwijzing is. | | `campaign__previous_conversation_id` | De ID van het vorige gesprek met de ontvanger. | | `campaign__previous_summary` | De samenvatting van het vorige gesprek. | | `campaign__previous_transcript` | Het transcript van het vorige gesprek. | ## Kanalen | Kanaal | Modus | Opmerkingen | | -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Telefoon | Spraak | Volledig gedrag voor retries, callbacks en doorverwijzingen. | | WhatsApp | Spraak | Er wordt één toestemmingsverzoek per ontvanger verzonden, gevolgd door retries en callbacks. Zie [uitgaande WhatsApp](/docs/nl/eleven-agents/whatsapp/outbound). | | WhatsApp | Tekst | Verzendt een goedgekeurde WhatsApp-berichttemplate naar elke ontvanger. Retries zijn niet van toepassing. Zie [uitgaande WhatsApp](/docs/nl/eleven-agents/whatsapp/outbound). | E-mail- en sms-kanalen komen binnenkort beschikbaar. ## Een campagne maken #### Open Campagnes Selecteer **Campagnes** in de ElevenAgents-navigatie. #### Sla je workspacebeleid op Open **Instellingen**, definieer je tijdzone, retrylimieten en belvensters en sla de wijzigingen op. Zie [Campagnebeleid](#campaign-policy). #### Maak de campagne Selecteer **Nieuwe campagne**, kies een agent, een kanaal en een telefoonnummer en upload vervolgens je ontvangers. Upload een CSV of dien ontvangers in via de API met dezelfde requeststructuur als een batchgesprek. Elke ontvanger kan maximaal vijf telefoonnummers hebben (`phone_number` tot en met `phone_number_5` in de CSV). #### Schakel geavanceerde functies in Schakel **Geavanceerde opties** in om retries, callbacks en follow-ups binnen opgegeven belvensters te activeren. Deze worden automatisch overgenomen uit je workspace-instellingen, of je kunt ze hier voor elke campagne aanpassen. #### Volg de voortgang Volg de voortgang op het tabblad **Analytics**. Gesprekken worden in de wachtrij geplaatst wanneer je een campagne maakt en gebeld zodra ze binnen een belvenster vallen. > **Warning** > > Campagnes zijn niet beschikbaar voor workspaces of agents die [Zero Retention Mode](/docs/nl/eleven-agents/customization/privacy/zrm) gebruiken. Beslissingen over follow-ups zijn afhankelijk van duurzame gespreksstatus > en gespreksanalyse. Daarom worden requests van workspaces met zero retention en inzendingen voor > agents met zero retention geweigerd. ## Gelijktijdigheid Campagnegesprekken tellen mee voor de gelijktijdigheidslimieten van je workspace en agent. Standaard gebruikt een campagne de laagste waarde van 50% van de gelijktijdigheid van je workspace of 70% van die van de agent. Je kunt voor een afzonderlijke campagne een lagere limiet instellen. ## API Het maken, beheren en analyseren van campagnes is beschikbaar via de ElevenLabs API, zodat je campagnes kunt integreren in je bestaande workflows en applicaties. Raadpleeg de [API-referentie](/docs/nl/api-reference/introduction) voor de beschikbare endpoints. ## Best practices * **Begin kleinschalig.** Test met een korte lijst en een voorzichtige `max_total_calls` voordat je de volledige doelgroep benadert. * **Stel vensters bewust in.** Belvensters zijn je belangrijkste middel om lokale beltijden te respecteren. Stel `timezone` in op de locatie van je ontvangers en houd vensters ruim binnen de toegestane uren. * **Verzamel de follow-upsignalen.** Campagnes verwerken callbacks, doorverwijzingen en niet-bellen-verzoeken alleen als de agent deze vastlegt. Geef de agent in de prompt aan wanneer elk signaal moet worden geregistreerd. * **Gebruik context voor follow-ups.** Verwijs in je prompt naar `campaign__previous_summary`, zodat een retry of callback verdergaat waar het vorige gesprek eindigde in plaats van de opening te herhalen. * **Houd limieten laag.** Doorzetten kost niet alleen jou, maar ook je ontvangers tijd. Kies liever voor enkele goed getimede pogingen dan voor veel pogingen. ## Veelgestelde vragen #### Kan ik het beleid van een lopende campagne wijzigen? Nee. Het beleid van een campagne wordt vastgelegd wanneer deze wordt gemaakt. Wijzigingen in je workspacebeleid gelden voor campagnes die je daarna maakt. Als je een lopende campagne wilt wijzigen, stop je deze en maak je een nieuwe. #### Kan een ontvanger in meer dan één campagne voorkomen? Elke campagne houdt eigen leads bij en de niet-bellen-status hoort bij de campagne. Ontdubbel ontvangers tussen campagnes voordat je ze maakt als je wilt voorkomen dat je iemand twee keer contacteert. ## Volgende stappen * [Gegevensverzameling](/docs/nl/eleven-agents/customization/agent-analysis/data-collection): Leg de signalen vast waarop je agent handelt. * [Dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables): Personaliseer het gesprek met elke ontvanger. * [Guardrails](/docs/nl/eleven-agents/best-practices/guardrails): Zorg dat je uitgaande agent bij het onderwerp en je merk blijft.