Zet in een paar regels op wat je net hebt geprobeerd, wat je verwachtte en
wat er in plaats daarvan gebeurde. Noem het bestand of de pagina erbij.
Soms komt de assistent er niet uit. Een koppeling die niet wil, een foutmelding die terugblijft komen, of een functie die zich anders gedraagt dan je verwacht. Dan wil je een mens. In het ⋯-menu van de assistent zit daarvoor Vraag Invoker om hulp.
Dat is geen contactformulier dat bij ons in een bak valt. Het bericht komt binnen met je account, je koppelstatus en de laatste logregels van je eigen account erbij, zodat we niet eerst drie mails nodig hebben om te weten waar we moeten kijken.
Drie soorten bericht
Boven het invulveld kies je het soort. Dat bepaalt hoe wij het oppakken.
| Soort | Wanneer | Wat wij ermee doen |
|---|---|---|
| Hulp nodig | Je wil iets voor elkaar krijgen en komt er niet | We antwoorden met de stappen, of doen het voor je |
| Iets werkt niet | Het gedrag is anders dan het hoort | We proberen het na te doen op onze eigen omgeving |
| Idee of verbetering | Je mist iets in de assistent | Het gaat op de lijst; veel functies zijn zo begonnen |
Daarnaast vul je een onderwerp in en je bericht. Het onderwerp mag 140 tekens zijn, het bericht ruim 8000. Je hoeft dus niet kort te zijn.
Wat er automatisch meegaat
Bij je bericht zetten wij, zonder dat je er iets voor hoeft te doen:
- Je account en de server waar het op staat.
- De website die je op dat moment open had staan in de assistent.
- Waar het bericht vandaan komt: de assistent, het paneel of de terminal.
- De versie van de plugin die op jouw server draait.
- De koppelstatus van Claude, Codex en GitHub, met het e-mailadres waarmee je gekoppeld bent.
- De laatste logregels van jouw account. Maximaal twaalf regels, en alleen regels van jouw eigen account.
Die laatste is in de praktijk de nuttigste. Negen van de tien keer staat daar al in waar het misging, en als het er niet in staat, weten we meteen dat we naar iets anders moeten kijken.
Je krijgt zelf een kopie per e-mail op het adres dat bij je account staat. Antwoorden wij, dan komt dat antwoord in dezelfde draad terecht, want je adres staat ook als antwoordadres in het bericht.
Wat je er zelf bij moet schrijven
Automatisch meesturen vervangt niet wat alleen jij weet. Drie dingen maken het verschil tussen een snel antwoord en een heen-en-weer:
- Wat je probeerde te doen, in gewone taal. Niet "het werkt niet" maar "ik wilde de preview publiceren naar de echte site".
- Wat je verwachtte en wat er gebeurde. Noem de letterlijke foutmelding als je die zag, ook als die onbegrijpelijk is.
- Of het eerder wel werkte, en wanneer het voor het laatst goed ging.
Een opdracht of een bericht uit de assistent mag je gewoon meekopiëren. Hoe letterlijker, hoe beter.
Wat je er niet in zet
Geen wachtwoorden. Niet van je account, niet van WordPress, niet van een database. Dat staat ook boven het formulier, en het geldt ook voor sleutels en tokens. Wij hebben ze niet nodig: wij kunnen op onze eigen servers kijken zonder jouw wachtwoord.
Krijg je een wachtwoord van de assistent te zien, bijvoorbeeld na een installatie, dan noem je in je bericht dat je het hebt, niet wat het is.
Per uur vijf berichten
Je kunt maximaal vijf berichten per uur versturen. Zit je aan die grens, dan krijg je de melding "Even geduld: maximaal vijf berichten per uur". Die grens zit er niet om je af te remmen maar om te voorkomen dat een script of een vastgelopen pagina honderden mails de deur uit duwt.
Vijf is in de praktijk ruim. Stuur liever één bericht met alles erin dan vijf losse met elk een regel.
Veelgemaakte fouten
"Ik stuur alleen een onderwerp." Dat mag technisch, maar het levert bijna altijd een tegenvraag op. Schrijf de drie dingen uit de vorige paragraaf erbij, dan zijn we een ronde sneller.
"Ik stuur mijn screenshot niet mee want dat kan niet." Dat is waar in dit formulier, maar je kunt de screenshot wel apart mailen als antwoord op de kopie die je zelf krijgt. Die kopie hangt al aan de juiste draad.
"Ik meld het bij het verkeerde soort." Niet belangrijk genoeg om over na te denken. Kies wat het dichtst in de buurt komt; wij lezen het bericht toch.
"Ik zet mijn wachtwoord erin, dan kunnen ze meteen inloggen." Doe dat niet. Verander het wachtwoord als je het al hebt gestuurd.
"Ik wacht met melden tot ik het zelf heb uitgezocht." Een melding met "ik weet niet waar ik moet kijken" is een prima melding. De logregels gaan immers mee, en daar begint ons zoekwerk toch.
Wil je eerst zelf verder zoeken, dan staat in de assistent valt stil: hervatten en ongedaan maken wat je kunt doen als een opdracht halverwege blijft hangen.