Met schrijfrecht op een sleutel voor de server Klanten kan een AI-tool een voorstel in de wachtrij van een klant zetten, en een eigen voorstel weer intrekken. Een adviseur beoordeelt het voorstel in de app, net als de voorstellen van de agents.
Schrijfrecht zet je aan bij het maken van de sleutel of later met Schrijven aan. Zie MCP-sleutels.
Een voorstel klaarzetten
klant_voorstel
Schrijft, alleen met schrijfrecht
Zet een voorstel in de wachtrij van een klant. Dit voert niets uit en verandert niets in een account of op de site: een adviseur ziet het voorstel in de app en beslist. Kies het kanaal waar het over gaat: google_ads (standaard), social_ads (Meta Ads; de cijfers komen uit klant_social), seo, cro, shopping (Merchant Center: feed en producttitels), lokaal (Google Bedrijfsprofiel en reviews), ai_zoekmachines (genoemd worden door AI-assistenten), content (artikelen en onderwerpen) of tracking (de Tag Manager-container); het voorstel komt bij die agent te staan. Elk kanaal heeft eigen dimensies. google_ads: adgroup, ads, audience, bidding, campaign, campaign_type, conversion_tracking, dayparting, device, extensions, geo, keyword, negatives, quality_score, searchterms. social_ads: ad_copy, adset, audience, bidding, budget, campaign, creative, lookalike, placement. seo: backlinks, content, internal_links, keywords, local, on_page, page_speed, schema, technical. cro: bereikbaarheid, cta, formulieren, inhoud, leesbaarheid, meting, mobiel, ontwerp, prijs, snelheid, vertrouwen. shopping: feed, feed_optimizer. lokaal: gmb_optimization, reviews. ai_zoekmachines: competitor_gap, content_opportunity, increase_citations, platform_specific. content: clarity_improvement, content_depth, create_cluster_content, create_pillar, improve_engagement, optimize_search, promote_top_content, refresh_opportunity, refresh_underperforming. tracking: container. Gebruik het als je iets hebt gevonden dat opgepakt moet worden, en zet in de onderbouwing waar je het aan ziet, met de cijfers erbij uit de tools die je gebruikt hebt. Een voorstel zonder cijfers kost een adviseur meer tijd dan het oplevert. Maximaal 10 per klant per dag over alle kanalen samen; kies dus wat er echt toe doet in plaats van alles wat opvalt.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| titel*(verplicht) | string | Wat er moet gebeuren, in één regel en in de gebiedende wijs. Hoogstens 300 tekens. | |
| onderbouwing*(verplicht) | string | Waarom, met de cijfers en de periode waarop je het baseert. Hoogstens 5000 tekens. | |
| dimensie*(verplicht) | string | Waar het over gaat, uit de lijst van het kanaal (zie hierboven) | |
| kanaal | string | google_ads | Bij welke agent het voorstel hoort: google_ads, social_ads, seo, cro, shopping, lokaal, ai_zoekmachines, content, tracking; default google_ads |
| urgentie | string | medium | low, medium (default), high of critical. Ook laag, middel, hoog of kritiek. |
| verwacht_effect | string | Optioneel: wat het naar verwachting oplevert. Hoogstens 200 tekens. |
* verplicht
Bij een geldig voorstel antwoordt de tool zo (voorbeeld met verzonnen id):
Voorstel staat in de wachtrij van Klant B.
id kanaal dimensie categorie urgentie status
-------- ---------- --------- --------- -------- -----------
1a2b3c4d google_ads negatives keywords hoog voorgesteld
Volledig id: <volledig id>
Nog 9 van de 10 voorstellen vandaag voor deze klant.
Een adviseur ziet hem in de app en beslist. Er is niets gewijzigd in een account of op de site en dat kan vanaf hier ook niet.
Let op
Daglimiet
- Standaard hoogstens 10 voorstellen per klant per dag via de MCP, over alle kanalen samen.
- De dag begint om middernacht UTC.
- Ingetrokken voorstellen tellen mee, zodat aanmaken en meteen weer intrekken de limiet niet omzeilt.
- Na elk voorstel meldt de tool hoeveel er die dag nog over zijn. Is de limiet bereikt, dan zegt de tool dat en maakt hij niets aan.
Dubbele voorstellen
Staat er voor dezelfde klant al een open MCP-voorstel met precies dezelfde titel, dan maakt de tool niets bij en noemt hij het id van het bestaande voorstel.
Sleutel met een selectie klanten
Een sleutel met een selectie klanten kan alleen voorstellen doen op een kanaal waarvan de agent bij die klant aanstaat. De tool noemt dan de kanalen waarop het wel kan.
Kanalen en dimensies
Elk kanaal heeft zijn eigen dimensies. Een dimensie die niet bij het kanaal hoort, wordt geweigerd met de lijst die wel kan.
| Kanaal | Dimensies |
|---|---|
google_ads | adgroup, ads, audience, bidding, campaign, campaign_type, conversion_tracking, dayparting, device, extensions, geo, keyword, negatives, quality_score, searchterms |
social_ads | ad_copy, adset, audience, bidding, budget, campaign, creative, lookalike, placement |
seo | backlinks, content, internal_links, keywords, local, on_page, page_speed, schema, technical |
cro | bereikbaarheid, cta, formulieren, inhoud, leesbaarheid, meting, mobiel, ontwerp, prijs, snelheid, vertrouwen |
shopping | feed, feed_optimizer |
lokaal | gmb_optimization, reviews |
ai_zoekmachines | competitor_gap, content_opportunity, increase_citations, platform_specific |
content | clarity_improvement, content_depth, create_cluster_content, create_pillar, improve_engagement, optimize_search, promote_top_content, refresh_opportunity, refresh_underperforming |
tracking | container |
Een voorstel intrekken
klant_voorstel_intrekken
Schrijft, alleen met schrijfrecht
Trek een voorstel in dat via deze MCP is aangemaakt en nog openstaat, bijvoorbeeld omdat het achterhaald is of omdat je het dubbel hebt gezet. Aanbevelingen die niet uit de MCP komen blijven hier buiten bereik: die zijn van de adviseur. Het voorstel blijft zichtbaar met jouw reden erbij, het verdwijnt niet.
Invoer
| Naam | Type | Beschrijving |
|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst |
| voorstel*(verplicht) | string | Het id uit klant_aanbevelingen (acht tekens), of het volledige id |
| reden*(verplicht) | string | Waarom je hem intrekt |
* verplicht
- Alleen een openstaand voorstel dat via de MCP is aangemaakt. Aanbevelingen van de agents en voorstellen die al beoordeeld zijn, kun je hier niet intrekken.
- Het voorstel blijft zichtbaar in de app, met je reden erbij en de naam van de sleutel als degene die het introk.
- Past het opgegeven id op meer dan één voorstel, dan vraagt de tool om meer tekens van het id.
Wat de adviseur ziet
Elk voorstel via de MCP komt in de tijdlijn van de klant, met de naam van de sleutel. Zo zie je altijd met welke sleutel, en dus door welke persoon of tool, het is klaargezet.