De chatbot aanpassen
Deze gids laat je zien hoe je de bot-app aan de providerkant een nieuwe vorm geeft zonder Control Center te verlaten.
Vereisten
Sectie getiteld “Vereisten”- De rol
ownerofadminin de werkruimte - Een verbonden provider. De rij Bot aanpassen verschijnt pas als de werkruimte is verbonden
- Een app die Control Center kan beheren. Voor Slack betekent dat dat de verbinding een refresh-token voor de app-configuratie bevat (
xoxe-…); is dat niet zo, dan zegt de rij dat en blijft hij uitgeschakeld
Wat je kunt wijzigen
Sectie getiteld “Wat je kunt wijzigen”| Veld | Betekenis | Limiet |
|---|---|---|
| App-naam | Hoe de provider de app vermeldt | 1–35 tekens |
| Botnaam (wat leden na @ typen) | Wat leden na @ typen |
1–80 tekens |
| Korte beschrijving | Eén regel die de provider toont | maximaal 140 tekens |
| Wat de bot zegt te kunnen | Staat boven een DM met de bot | maximaal 300 tekens |
| Slash-commando | Het commando dat leden aanroepen, zonder de schuine streep | Kleingeschreven, alleen a–z 0–9 _ -, afgekapt op 32 tekens |
| Directe berichten | Of de bot de DM- en agentervaring aanbiedt | Aan of uit |
Control Center valideert de vier tekstvelden voordat het de provider aanroept, dus krijg je “the app name must be between 1 and 35 characters” in plaats van een ondoorzichtige invalid_manifest van een server die je niet kunt zien. Het commando wordt niet geweigerd maar genormaliseerd: een leidende schuine streep wordt verwijderd, de rest wordt kleingeschreven, alles buiten a–z 0–9 _ - wordt weggelaten en een lege uitkomst valt terug op cc.
De bot bewerken
Sectie getiteld “De bot bewerken”- Ga naar Instellingen → Werkruimte → Algemeen en scrol naar de kaart Chatbruggen
- Klik in het blok van de provider op Bot aanpassen
- Het dialoogvenster opent met de actuele waarden van de app, teruggelezen van de provider — dus een wijziging die iemand in de eigen interface van Slack heeft gemaakt, is wat je als uitgangspunt ziet
- Bewerk wat je nodig hebt en sla op
Het lezen van die actuele waarden kost aan de kant van Slack een tokenrotatie. Daarom is de rij een bewuste klik en niet iets wat de pagina bij het laden doet.
De schrijfactie legt je wijzigingen over de huidige definitie van de app. Alles wat Control Center niet modelleert — een tweede slash-commando dat je in Slack hebt toegevoegd, een workflowstap, een instelling die er niets mee te maken heeft — blijft onaangeroerd. Scopes en gebeurtenissen worden samengevoegd, nooit afgetrokken.
Na het opslaan leest Control Center de identiteit van de bot opnieuw, zodat de naam in de instellingen overeenkomt met de naam in de chat-app.
Opnieuw installeren wanneer de rechten wijzigen
Sectie getiteld “Opnieuw installeren wanneer de rechten wijzigen”Wanneer een opslag de rechten wijzigt, blijft het dialoogvenster open en staat er “Slack heeft de rechten van de app gewijzigd. Installeer de app opnieuw zodat ze van kracht worden”, met een knop App opnieuw installeren die de pagina van Slack opent waar die app in het team wordt geïnstalleerd. In Slack heet dat Install App → Reinstall to Workspace.
Het slash-commando hernoemen
Sectie getiteld “Het slash-commando hernoemen”Wijzig Slash-commando en sla op. De brug schrijft daarna instructies met het commando waarmee hij het laatst is aangeroepen, zodat de helptekst en de koppelinstructies de hernoeming volgen in plaats van een commando te noemen dat niet meer bestaat.
Hernoemen breekt bestaande gebrugde threads niet: threads zijn gekoppeld aan het gesprek, niet aan het commando.
Wat Control Center niet wijzigt
Sectie getiteld “Wat Control Center niet wijzigt”- Structurele instellingen. Het transport (Socket Mode), de vereiste scopes en de gebeurtenisabonnementen worden afgedwongen, niet aangeboden. Een app die je vanaf een instellingenscherm tot stilte kunt configureren, is een supportticket, geen functie
- Het pictogram van de bot. Alleen de eigen app-instellingen van de provider kunnen het wijzigen, en het dialoogvenster zegt dat ook
- De eigen functiemigraties van de provider. Een app die al op de oude assistant-vorm van Slack zit, behoudt die; dit dialoogvenster bewerkt een beschrijving en migreert geen app
Problemen oplossen
Sectie getiteld “Problemen oplossen”De rij “Bot aanpassen” ontbreekt helemaal
Sectie getiteld “De rij “Bot aanpassen” ontbreekt helemaal”De werkruimte is nog niet verbonden. De rij verschijnt pas als het blok van de provider een actieve verbinding toont. Zie Slack-integratie instellen.
De rij “Bot aanpassen” is uitgeschakeld
Sectie getiteld “De rij “Bot aanpassen” is uitgeschakeld”De verbinding heeft geen inloggegevens voor app-beheer — de ondertitel van de rij zegt “Control Center heeft een app-configuratietoken nodig om de bot te bewerken. Verbind opnieuw en geef er een mee.” Genereer voor Slack op api.slack.com/apps een paar app-configuratietokens en verbind opnieuw met het refresh-token ingevuld. Dit is te verwachten bij een app die met de hand is gebouwd of via Maken in Slack is gemaakt, want Slack meldt nooit welke app het heeft gemaakt.
“Control Center does not know which app to edit”
Sectie getiteld ““Control Center does not know which app to edit””De opgeslagen verbinding bevat geen app-id — doorgaans een app die met de hand is verbonden voordat er een id werd vastgelegd. Verbind de werkruimte opnieuw, of maak de app vanuit Control Center aan.
De nieuwe naam van de bot is nog niet in de chat verschenen
Sectie getiteld “De nieuwe naam van de bot is nog niet in de chat verschenen”Providers cachen de metadata van apps kort. Als de naam na een minuut nog steeds verouderd is, controleer dan of het opslaan je vroeg om de app opnieuw te installeren.