Belgroepen
Een belgroep belt de mensen in je werkruimte die online zijn in de browsertelefoon. Routeer een nummer, of de standaardroute van je werkruimte, naar een groep. Een inkomende oproep laat dan de online leden van de groep in het dashboard overgaan tot een van hen opneemt.
Elke werkruimte heeft een groep Everyone die iedereen belt die online is. Voeg je eigen groepen toe om een kleiner team te bellen, zoals support of sales, en koppel elk nummer aan de groep die het moet beantwoorden.
Voordat je begint
- Leden die online gaan. Een belgroep belt alleen leden die online zijn in de browsertelefoon. Oproepen ontvangen legt uit hoe je online gaat en wie dat kan.
- Toestemming om Voice te beheren. Om belgroepen te bekijken heb je
voice_managementop leesniveau nodig. Om groepen aan te maken, te hernoemen en te verwijderen, leden te wijzigen en een nummer naar een groep te routeren, heb je deze op schrijfniveau nodig. - Voor de API of CLI: een API-sleutel met de scope
voice_managementop het niveau dat de bewerking vereist.
De standaardgroep
De groep Everyone staat altijd bovenaan de lijst. De leden zijn alle gebruikers die online zijn in de werkruimte op het moment dat een oproep binnenkomt, dus je voegt er nooit iemand aan toe. Je kunt de groep niet hernoemen of verwijderen en de leden niet wijzigen: een verzoek daartoe wordt geweigerd met 409 en E21072.
De ID bestaat uit vrg_ gevolgd door het achtervoegsel van je werkruimte-ID, en is dus bij elke uitlezing hetzelfde. Gebruik deze overal waar een belgroep-ID wordt geaccepteerd.
Een belgroep maken
- Open Voice > Ring groups en selecteer New ring group.
- Voer een Name in en selecteer Create ring group.
- Selecteer in Members van de groep Add member en kies elke gebruiker die de groep moet laten overgaan. De lijst toont gebruikers die toegang hebben tot de werkruimte.
De kolom Online telt de leden van een groep die online zijn en oproepen aannemen. Daarbij horen ook leden die in gesprek zijn; hun telefoon gaat pas over als dat gesprek is beëindigd. Een nieuwe groep heeft geen leden, dus de kolom toont 0 totdat je leden toevoegt.
Via de API maak je de belgroep en voeg je elk lid toe op basis van gebruikers-ID. Gebruikers-ID's vind je met bird members list, waarvoor je de scope members op leesniveau nodig hebt.
const group = await bird.voice.ringGroups.create({ name: "Support" });
console.log(group.id, group.name);group = client.voice.ring_groups.create(name="Support")
print(group.id, group.name)group, err := client.Voice.RingGroups.Create(context.Background(), bird.VoiceRingGroupsCreateParams{
Name: "Support",
})
if err != nil {
log.Fatal(err)
}
fmt.Println(group.Id, group.Name)$group = $bird->voice->ringGroups->create((new VoiceRingGroupCreate())->setName('Support'));
echo $group->getId(), ' ', $group->getName(), "\n";bird voice ring-groups create --name Supportcurl -X POST "https://{region}.platform.bird.com/v1/voice/ring-groups" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Support"
}'const member = await bird.voice.ringGroups.members.create("RING_GROUP_ID", { user_id: "USER_ID" });
console.log(member.user_id);member = client.voice.ring_groups.members.create("RING_GROUP_ID", user_id="USER_ID")
print(member.user_id)member, err := client.Voice.RingGroups.Members.Create(context.Background(), "RING_GROUP_ID", bird.VoiceRingGroupsMembersCreateParams{
UserID: "USER_ID",
})
if err != nil {
log.Fatal(err)
}
fmt.Println(member.UserId)$member = $bird->voice->ringGroups->members->create('RING_GROUP_ID', (new VoiceRingGroupMemberCreate())->setUserId('USER_ID'));
echo $member->getUserId(), "\n";bird voice ring-groups members create <ring-group-id> \
--user-id usr_01krdgeqcxet5s7t44vh8rt9mgcurl -X POST "https://{region}.platform.bird.com/v1/voice/ring-groups/{ring_group_id}/members" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"user_id": "usr_01krdgeqcxet5s7t44vh8rt9mg"
}'Een gebruiker die later de werkruimte verlaat, blijft in de lijst staan totdat je hem verwijdert, maar de groep belt hem nooit. Om een lid te verwijderen selecteer je Remove naast het lid, of verwijder je het lid via de API. Vanaf de volgende oproep gaat de telefoon van een verwijderd lid niet meer over.
Oproepen naar een belgroep routeren
Een nummer belt een groep wanneer de eigen route van het nummer, of de standaardroute van de werkruimte die het volgt, die groep noemt.
- Eén nummer: open Voice > Numbers, open het nummer en kies onder Inbound routing de optie Ring a ring group. Kies de groep en selecteer Save.
- Elk nummer zonder eigen route: selecteer op de pagina Numbers naast Calls to numbers without their own route de optie Change, kies Ring a ring group en de groep, en sla op.
Via de API stel je de route in op {"type": "ring_group", "ring_group_id": "<id>"} wanneer je het nummer bijwerkt, of voor de standaardroute in de spraakinstellingen. Een ring_group_id die niet de standaardgroep is en ook geen groep in de werkruimte, wordt geweigerd met 422.
bird voice numbers update vnu_01krdgeqcxet5s7t44vh8rt9mg \
--route ring_group --ring-group-id vrg_01krdgeqcxet5s7t44vh8rt9mgcurl -X PATCH "https://{region}.platform.bird.com/v1/voice/numbers/vnu_01krdgeqcxet5s7t44vh8rt9mg" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"inbound_configuration": {
"route": {
"type": "ring_group",
"ring_group_id": "vrg_01krdgeqcxet5s7t44vh8rt9mg"
}
}
}'bird voice settings update accepteert dezelfde --route ring_group --ring-group-id-flags voor de standaardroute. Oproepen ontvangen behandelt de andere routes en legt uit hoe je een nummer terugzet naar de standaardroute.
Een reeks kan ook een groep laten overgaan, vanuit een belstap. De uitkomst van die stap zet de reeks daarna voort. Daar hoort een voicemail of een doorschakeling thuis als niemand in de groep opneemt.
Hoe een belgroep overgaat
Als er een oproep voor een groep binnenkomt, leest Bird welke leden van de groep op dat moment gebeld kunnen worden en zet ze in een willekeurige volgorde:
- Leden worden met vijf tegelijk gebeld, maximaal 20 seconden per groepje. Als elk lid van een groepje weigert of onbereikbaar is, start het volgende groepje meteen.
- Het overgaan stopt na in totaal 60 seconden.
- Het eerste lid dat Accept selecteert, neemt de oproep aan, en bij de anderen stopt het overgaan.
- Een lid wordt op maar één apparaat gebeld: de browser die zijn onlinestatus bevat.
Een lid wordt overgeslagen als het offline is, op Busy staat, al in gesprek is, of op Not accepting calls staat na drie gemiste oproepen op rij. Je status legt elke status uit.
De beller hoort de kiestoon terwijl de leden worden gebeld, en de oproep wordt pas beantwoord als een lid accepteert. De tijd van het overgaan wordt dus niet in rekening gebracht. Als niemand binnen 60 seconden opneemt, of niemand gebeld kan worden, weigert een nummer dat rechtstreeks naar de groep routeert de oproep. Wil je onbeantwoorde bellers ergens anders heen sturen, routeer het nummer dan naar een reeks die de groep belt en daarna doorgaat.
In de voice legs API noemt de leg van de beller hen in answered_by. In een opname of transcriptie noemt user_id van de partij het lid aan die kant.
Een belgroep verwijderen
Selecteer de groep op de pagina Ring groups en selecteer Delete ring group. Gesprekken die al bij de leden overgaan, blijven ongewijzigd.
Je kunt geen groep verwijderen die nog door een nummer, de standaardroute van de werkruimte of een gepubliceerde reeks wordt gebeld: het verzoek wordt dan geweigerd met 409 en E21071. Stel eerst voor elk ervan een andere route in en verwijder daarna de groep.
Limieten
| Limiet | Waarde |
|---|---|
| Belgroepen per werkruimte, naast Everyone | 50 |
| Leden per belgroep | 200 |
| Leden die tegelijk worden gebeld | 5 |
| Beltijd per oproep | 60 s |
De standaardgroep heeft geen ledenlimiet. Als je een groep aanmaakt of een lid toevoegt boven een limiet, wordt dat geweigerd met 422 en een bericht dat de limiet noemt. Hoeveel gebruikers tegelijk online kunnen zijn, is een limiet van de organisatie, beschreven in Limiet voor online gebruikers.
Belgroepen beheren via de API, CLI of MCP
| Taak | API | CLI |
|---|---|---|
| De groepen van de werkruimte weergeven | Belgroepen weergeven | bird voice ring-groups list |
| Een groep aanmaken | Een belgroep aanmaken | bird voice ring-groups create |
| Een groep hernoemen | Een belgroep bijwerken | bird voice ring-groups update |
| Een groep verwijderen | Een belgroep verwijderen | bird voice ring-groups delete |
| De leden van een groep weergeven | Leden weergeven | bird voice ring-groups members list |
| Een lid toevoegen | Een lid toevoegen | bird voice ring-groups members create |
| Een lid verwijderen | Een lid verwijderen | bird voice ring-groups members delete |
De MCP-server biedt dezelfde bewerkingen aan als voice_ring_groups_*-tools, en de tools voice_numbers_update en voice_settings_update accepteren een ring_group-route. Elke opgevraagde groep bevat online_member_count, hetzelfde aantal als in de kolom Online.
Volgende stappen
| Pagina | Wat er wordt behandeld |
|---|---|
| Telefoon | Online gaan, je status en een gesprek beantwoorden in de browser |
| Gesprekken ontvangen | Alle routes die een nummer kan volgen, en hoe je een geweigerd gesprek interpreteert |
| Gesprekslogboek | De registratie die elk gesprek achterlaat, en hoe je die filtert en exporteert |
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.