Een time-out vertelt niet of het aanmaken van de mailbox is mislukt. Je systeem moet de klantaanvraag aan het resultaat kunnen koppelen. Houd aanmaken, doorsturen en gereedmelden apart, zodat een onderbreking niet leidt tot nog een blinde klik op Aanmaken.
Je kunt een programma mailboxen laten aanmaken en doorsturen laten instellen via de TrekMail-API. Daarmee geeft je systeem opdrachten aan de dienst in plaats van dat een medewerker steeds dezelfde handelingen in het paneel doet. Voor zulke wijzigingen zijn Pro of Agency, passende rechten en toegang tot het gekozen domein nodig.
Bepaal wat je precies wilt maken
Beschrijf de taak eerst gewoon. 'Een medewerker heeft een persoonlijke mailbox nodig' en 'berichten op een algemeen adres moeten ergens anders aankomen' vragen om andere instellingen.
Een volledige mailbox bewaart eigen gesprekken. Je kunt daarop doorsturen instellen en beslissen of een lokale kopie blijft. Een doorstuuradres zonder mailbox is voor ontvangst op één adres en doorgeven zonder eigen archief op die plek. Voorwaarden en limieten van die varianten verschillen.
Scheid ook mailbeheer van werken met berichtinhoud. Een adres aanmaken vereist niet automatisch het lezen van medewerkersmail. Inhoud is een aparte API-mogelijkheid. Geef die niet aan een programma dat alleen mailboxen maakt.
Leg dit vóór ontwikkeling vast. De specialist weet dan welke soort voorziening nodig is en welk resultaat je in het paneel verwacht.
Bereid abonnement en beperkte toegang voor
Een functie handmatig kunnen instellen betekent niet altijd dat je die via API mag veranderen. Mailboxen aanmaken en doorsturen wijzigen vereisen Pro of Agency. Starter staat lezen van toegankelijke infrastructuurinstellingen toe, maar dat is niet genoeg voor deze automatisering.
Maak aparte programmatoegang en beperk die tot nodige acties en domeinen. Een programma voor één bureauklant hoort alleen met diens gegevens en voorzieningen te werken.
De rechten van degene die toegang geeft tellen ook mee. Je kunt niet meer bevoegdheden doorgeven dan je zelf hebt. De API-rechtenhandleiding beschrijft rechten en abonnementsgrenzen.
Bewaar de sleutel in de serverinstellingen van de integratie. Toon die niet in het klantformulier en stuur hem niet in een welkomstmail. Een gebruiker heeft genoeg aan het gemaakte adres en de afgesproken manier om te beginnen.
Bouw een duidelijke aanmaakvolgorde
Bepaal het toegestane domein op basis van je eigen klantgegevens. Een domein-ID uit de browser bewijst geen recht op dat domein.
Bekijk daarna of het adres al bestaat en of er ruimte binnen de limieten is. Bestaat de mailbox al, bepaal dan of die bij dezelfde aanvraag hoort. Een tweede klik mag geen onduidelijke situatie opleveren.
Stel na aanmaak doorsturen in als de taak dat vereist. Beslis bij een volledige mailbox vooraf over de lokale kopie. Als iemand daar een archief verwacht, moet dat geen toevallige standaardkeuze zijn.
Bestaat de mailbox maar mislukt doorsturen, leg die gedeeltelijke uitkomst vast en herstel die stap. Meld pas Gereed nadat bezorging en lokale kopie zijn gecontroleerd.
De TrekMail-API-uitleg beschrijft methoden en verzoekformaten. Gebruik die als specificatie voor de ontwikkelaar en houd het gebruikersproces eenvoudig.
Houd rekening met herhalen en fouten
Gebruik bij een als idempotent beschreven bewerking dezelfde Idempotency-Key voor dezelfde aanvraag en inhoud. Bewaar de mailbox-ID en controleer herhaalregels voor andere bewerkingen apart.
In andere gevallen zoekt de integratie eerst of het adres al is aangemaakt. Herhaal een aanmaakopdracht niet blind na ieder onduidelijk antwoord. Bewaar de relatie tussen aanvraag en resultaat om vanaf de juiste stap verder te gaan.
Behandel onvoldoende opslag, bereikte limieten en geweigerde toegang apart. Hetzelfde verzoek herhalen lost die oorzaken niet op. Een duidelijke uitleg en verantwoordelijke helpen meer dan eindeloos 'Mailbox aanmaken'.
Beloof bij een grote groep geen gelijke doorlooptijd voor elke aanvraag. Toon liever de status per geval en welke aandacht nodig hebben.
Test eerst één domein
Begin met een testdomein en enkele adressen. Controleer normale aanmaak, dezelfde aanvraag opnieuw en een poging op een domein buiten het toegestane bereik.
Stuur daarna naar het gemaakte adres. Controleer bij doorsturen de eindontvanger en lokale kopie volgens de gekozen stand. Een geslaagd API-antwoord vervangt geen test van het mailgebruik.
Spreek vóór de start af wie fouten ziet en handmatig kan herstellen. Bewaar een aanvragenlog zonder geheime sleutels en wachtwoorden. Werkt dit kleine proces voorspelbaar, voeg het dan toe aan de komst van medewerkers of klanten.
Gebruik het API-overzicht. Mailboxen aanmaken vraagt niet om het lezen van gebruikersmail; geef alleen de benodigde infrastructuurrechten.