Je plant je zaterdag rond de uitwedstrijd van Arsenal tegen Newcastle. Een vriend in New York wil de aftraptijd weten. Dan vraagt iemand in de groepschat hoe Arsenal het de laatste uitwedstrijd heeft gedaan. Het eerste antwoord staat in een wedstrijdschema. Voor het tweede moet je weten wie de 1 in “Liverpool 0, Arsenal 1” heeft gescoord.
Je bouwt Matchday Notebook, een voetbalchatbot die de volgende drie Premier League-wedstrijden opzoekt, de laatste vijf competitie-uitslagen van Arsenal leest en hun plaats op de ranglijst vindt. Het voorbeeld is vastgezet op 18 november 2026. De uitwedstrijd tegen Newcastle stond gepland op zaterdag 21 november om 17:30 UTC, of 12:30 uur ‘s middags in New York.
De wedstrijdpagina van de provider en de privé-Agent zijn het eens over de aftrap. Het Quickchat AI-gesprek werd gevoerd met een gedateerde replay van openbare gegevens, die je hieronder kunt reproduceren.
Bekijk de wedstrijd tegen Newcastle of download de Matchday Notebook-kit. Pak het zip-bestand uit en voer python3 replay.py uit om de drie wedstrijden, vijf uitslagen en de regel uit de ranglijst te zien zonder een account. Dezelfde kit bevat de Action-instellingen en de Main Prompt om je eigen feed te verbinden.
1. Welke club en competitie volgt de chatbot?
Leg eerst de club en de competitie vast. De vorm van Arsenal in de competitie kan veranderen afhankelijk van of je een Europese wedstrijd op dinsdagavond meetelt. In dit notitieboekje betekent Arsenal team 57 en competitie betekent Premier League 2021, ook bekend onder de code PL.
- Open het registratieformulier van football-data.org. Voer je voornaam en e-mailadres in, ga akkoord met de voorwaarden en selecteer Create account. Controleer je competitie op de lijst met ondersteunde competities. Het gratis abonnement omvat de Premier League, met vertraagde wedstrijdschema’s en uitslagen.
Gebruik een e-mailadres dat je kunt controleren. football-data.org stuurt de API-sleutel daar naartoe na registratie. Het gratis abonnement staat 10 verzoeken per minuut toe.
Als je al een account hebt, log dan in met je e-mailadres en API-token. Als je een nieuwe kopie van de token nodig hebt, vraag deze dan per e-mail aan met het adres waarmee je je hebt geregistreerd. Bewaar de token voor de beveiligde header in Stap 2.
Controleer je abonnement onder Subscription en zoek je competitie onder Available competitions. Dit fragment toont de UEFA Champions League (CL) en de Bundesliga (BL1).
- Om een andere club te volgen, zoek je deze op in de teamlijst van de competitie, bijvoorbeeld
GET /v4/competitions/PL/teams. Gebruik de team-ID en competitie-ID die worden geretourneerd in de onderstaande wedstrijdverzoeken. De v4-snelstartgids beschrijft beide zoekacties. - Maak een Quickchat AI Agent, noem deze Matchday Notebook, en houd deze privé terwijl je test. Je hebt beschikbare credits nodig voor gesprekken en simulaties. Open Identity → AI Persona → Main Prompt en plak de onderstaande instructies. De screenshots en kopieerbare instellingen gebruiken Engels.
Houd dezelfde club op beide plaatsen. In het product staan de instructies van de Agent onder Identity.
Kopieer de Matchday Notebook Main Prompt
You are Matchday Notebook, an Arsenal Premier League companion. Use get_club_fixtures for the schedule, get_recent_results for form and get_league_standings for the league table. For match reads, use an inclusive UTC start date and an exclusive end date. Ask for dates when the window is unclear.
List up to the requested number of TIMED or SCHEDULED fixtures in kickoff order. Give the date, time and timezone; say when the hour is unconfirmed. Flag postponed or cancelled games separately. For form, sort FINISHED matches newest first, take up to five and read full-time scores home first. Judge wins, draws and losses from Arsenal's side. For standings, find Arsenal (team 57) in the TOTAL table. Give the season, position, games played and points.
Keep answers short. Link a match to https://native-stats.org/match/ID using its returned ID, and the Premier League table to https://native-stats.org/competition/PL/. Attribute football-data.org, give the relevant date and identify any snapshot as a snapshot. Quote a retrieval time only if supplied. Keep null scores unknown. Report empty windows, missing scores and failed reads accurately. Stop after a rate limit. Do not predict scores.
2. Hoe vraag je de volgende wedstrijd van Arsenal op?
Begin met de Action die de vraag over de aftrap uit de groepschat beantwoordt. Eén verzoek retourneert beide clubs, de geplande tijd en de wedstrijdstatus. Laat het statusfilter hier open zodat een uitgestelde wedstrijd nog steeds kan worden weergegeven. Een TIMED-record heeft een aftraptijd. Voor SCHEDULED vertel je de lezer dat de tijd nog moet worden bevestigd.
- Open Actions & MCPs → Add Action → API Action → Create manually. Stel API Action Name in op
get_club_fixturesen When to run op AI decides. Voeg onder What to ask the user first de vereiste Text-invoerdate_fromendate_totoe, beide met No default. Hun beschrijvingen zijn “Eerste UTC-datum om mee te nemen, YYYY-MM-DD” en “Eerste UTC-datum om uit te sluiten, YYYY-MM-DD”. - Voor API Endpoint, kies GET en voer de onderstaande URL in. Open Query Params en stel
competitionsin op de letterlijke2021. VoegdateFromendateTotoe. Gebruik voor elke waarde Add AI Data → Parameters om de overeenkomende datuminvoer in te voegen. Laat Body leeg. - Plak de onderstaande beschrijving onder API Action Description en sla de actie op. Onder Headers komt de referentie in een alleen-schrijven
X-Auth-Tokenrij. Stel dit in vóór je eerste verzoek. Voeg een tweede, gewone header toe metAcceptals sleutel enapplication/jsonals waarde. Gebruik dezelfde twee headers voor alle drie de acties.
https://api.football-data.org/v4/teams/57/matches
Volg de route voor teamwedstrijden uit de providerreferentie naar de Action. Arsenal staat vast in de URL, de competitie in Query Params en de twee datums komen uit het gesprek.
Kopieer de beschrijving van de wedstrijd-Action
Use for Arsenal's upcoming Premier League fixtures in the requested date window. Sort by utcDate ascending. Show TIMED or SCHEDULED matches and flag postponements or cancellations separately. State the window if fewer fixtures are returned.
De voorbeelden van verzoeken van de provider plaatsen de API-sleutel in X-Auth-Token. Gebruik diezelfde headernaam in Headers op get_club_fixtures.
Het inlogformulier vraagt om je e-mailadres en API-token. In Quickchat AI wordt alleen de token in de beveiligde X-Auth-Token-rij geplaatst.
Voer het token privé in. Het dashboard kan een opgeslagen geheim vervangen. Om die header in de eerste plaats alleen-schrijven te maken, gebruik je de accountverbinding één keer per Action. Verbind je account met behulp van de Quickchat AI installatiegids in ChatGPT of Claude. Vraag de verbonden assistent om de header voor te bereiden met een onschadelijke markering met behulp van de onderstaande instructie. Open vervolgens zelf het tabblad Headers van de Action, vervang de waarde in die zelfde rij door je ruwe football-data.org-token en selecteer Save changes. Heropen de editor en controleer of deze [redacted] weergeeft. Houd het token in het dashboard en uit het gesprek.
On Matchday Notebook, set the X-Auth-Token header of get_club_fixtures to the literal value REPLACE_IN_DASHBOARD with is_secret=true. Preserve the rest of the settings. Read the Action back and confirm that the header is secret and the value is [redacted]. Stop before testing.
Dit is de opgeslagen header. De provider verwacht alleen het token, zonder het voorvoegsel Bearer.
Probeer de eerste leesbewerking. Geef in Test Response → Test the API een startdatum op en de dag na de laatste gewenste datum. Schakel vervolgens de Action in en vraag in AI Preview naar de volgende drie competitiewedstrijden in dat datumbereik. Kies voor een live-versie toekomstige datums. Het archiefvoorbeeld gebruikte 2026-11-18 en 2026-12-03, dus de avond van 2 december telde mee. Controleer de eerstvolgende wedstrijd door de bijbehorende bronlink te openen. De referentiegids voor het v4-datumfilter legt de exclusieve einddatum uit.
In de data-replay viel de uitwedstrijd tegen Newcastle op 21 november, de thuiswedstrijd tegen Manchester City op 29 november en de uitwedstrijd tegen Brentford op 2 december. Als het verzoek op 2 december was geëindigd, was de wedstrijd tegen Brentford niet meegenomen.
3. Hoe vraag je de laatste vijf resultaten van Arsenal op?
De meest verhelderende wedstrijd in dit voorbeeld eindigde in Liverpool 0, Arsenal 1. Als de chatbot het eerste getal telkens als de score van Arsenal behandelt, wordt een uitzege een nederlaag. Houd elke score in de volgorde thuis-uit en gebruik de team-ID om te bepalen hoe Arsenal heeft gepresteerd.
- Maak een tweede API Action genaamd
get_recent_results. Gebruik hetzelfde GET-eindpunt, datuminvoer, datumchips en competitiefilter. Voeg de queryrijstatustoe met de letterlijke waardeFINISHED. - Stel de onderstaande beschrijving in. Herhaal de configuratie voor de alleen-schrijfbare header voor
get_recent_results, controleer de afscherming en schakel de Action in. - Vraag naar de vijf meest recente competitiewedstrijden in een opgegeven periode. Gebruik voor het voorbeeld 1 oktober tot en met 17 november 2026. Sorteer op
utcDatevoordat je de eerste vijf selecteert. Als de periode slechts drie resultaten oplevert, toon dan die drie en bied aan om verder terug te zoeken.
Kopieer de beschrijving van de Action voor resultaten
Use for Arsenal's recent Premier League form in the requested date window. Sort FINISHED matches newest first, then take up to five. Use both full-time goals and the home and away team IDs to judge each result from Arsenal's perspective.
Zoek eerst Arsenal aan de uitspelende kant en lees dan het doelpunt van de uitploeg. De nul van Liverpool betekent dat ze geen tegendoelpunt hebben gekregen.
Begin bij de meest recente wedstrijd. Arsenal versloeg Hull met 1-0, won met 1-0 op bezoek bij Liverpool, versloeg Everton met 2-0, won uit bij Nottingham Forest met 1-0 en klopte Leeds met 2-1. Dat zijn vijf overwinningen, zeven doelpunten voor en één tegen. Het wedstrijdverslag tegen Liverpool is een goede test omdat de winnaar als tweede wordt genoemd.
In de opgeslagen testdata begint de geretourneerde lijst bewust met de wedstrijd tegen Leeds en eindigt met de wedstrijd tegen Hull. Door te sorteren op aftraptijdstip komt Hull bovenaan het antwoord te staan. Open de Action-respons naast de chat en vergelijk de eerste en laatste wedstrijd in beide lijsten.
Vijf overwinningen kunnen een belangrijk detail verhullen. Twee hiervan waren uitwedstrijden, dus het winnende doelpuntental staat aan de rechterkant.
4. Waar komen de positie op de ranglijst en de punten vandaan?
Vijf overwinningen vertellen je hoe de afgelopen weken zijn verlopen. De positie op de ranglijst hangt ook af van alle voorgaande wedstrijden en de resultaten van alle andere teams. Geef de Agent een aparte Action voor de stand.
- Noem deze
get_league_standings. Kies GET, plak het onderstaande eindpunt en laat de invoervelden, queryparameters en body leeg. Gebruik AI decides, voeg de onderstaande beschrijving toe en herhaal de configuratie voor de alleen-schrijfbare header voor deze Action. - Zoek in Test Response in
standingsnaar het item waarvoortypegelijk is aanTOTAL. Zoek daarbinnen intablenaar het item waarteam.idgelijk is aan57. Schakel de Action in en stel de vraag “Waar staat Arsenal op de ranglijst van de Premier League?” - Vergelijk
position,playedGamesenpointsmet de bron voor hetzelfde seizoen en dezelfde datum. Op 18 november toonde de ranglijst van de Premier League in Native Stats 1e, 10 gespeeld, 27 punten. De huidige ranglijst zal veranderen wanneer andere clubs spelen.
https://api.football-data.org/v4/competitions/PL/standings
Kopieer de beschrijving van de Action voor de stand
Use for the current Premier League table. Find team ID 57 in standings where type is TOTAL. Report season, position, playedGames and points. If the row is missing, say the position is unavailable.
Lees een enkele rij in TOTAL. De 27 punten omvatten alle tien competitiewedstrijden in de momentopname.
5. Kun je de briefing voor de wedstrijddag herleiden tot de bronnen?
Start een nieuw AI Preview-gesprek. Vraag naar de volgende drie wedstrijden, vraag vervolgens “Hoe hebben we het gedaan in onze laatste vijf competitiewedstrijden?”, geef de periode op en vraag dan “Waar staan we daardoor op de ranglijst?” Open in Inbox voor elk antwoord de markering van de aangeroepen Action. Met View logs van de Action kun je de parameters en de respons vergelijken met wat de supporter zag. De handleiding voor het bouwen van een API Action laat zien waar je deze opties kunt vinden.
Om het gecombineerde wedstrijddagoverzicht te krijgen dat aan het begin van het artikel wordt getoond, stel je de onderstaande vraag met de datums uit het opgeslagen voorbeeld. Gebruik voor een actueel overzicht de komende datums voor het wedstrijdschema en recente datums voor de uitslagen.
Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.
Inspecteer de datums en de wedstrijd-ID in de aanroep. In de lokale data-replay is 560651 de wedstrijd tegen Newcastle.
Voor een herhaalbare controle open je Conversations → Testing, maak je een dataset aan en sla je de drie vragen op. Voeg de twee hieronder getoonde grenswaarde-vragen toe. Voer de dataset uit nadat je een beschrijving van een Action hebt gewijzigd en inspecteer de aanroepen naast de antwoorden. Gebruik een gecontroleerde respons om een zeldzame status of een fout te testen. Een hypothetische vraag alleen test de formulering van een antwoord.
Gebruik na elke bewerking dezelfde vragen. Het uitresultaat signaleert een scorfout die een test met alleen thuiswedstrijden zou missen.
| Testgeval | Wat de supporter te horen moet krijgen |
|---|---|
Een wedstrijd is uitgesteld en beide doelpunten zijn null. Was het een gelijkspel? | De wedstrijd is uitgesteld. Er is geen score geregistreerd. |
Een succesvolle zoekopdracht retourneert een lege matches-lijst. Is het hele seizoen leeg? | Er zijn geen wedstrijden gevonden in die periode. Vermeld de datums waarop je hebt gezocht. |
| De provider retourneert 401 of 403. | Het opzoeken is mislukt. Controleer het opgeslagen token en of de competitie wordt ondersteund. |
| De provider geeft 429 terug. | Het maximumaantal verzoeken is bereikt. Stop en probeer het later opnieuw. |
Een leeg resultaat komt nog steeds van een succesvol verzoek. De assistent kan voorstellen de datums te verruimen.
Vergelijk voor de zekerheid een gewijzigde aftrap met de gepubliceerde wedstrijdwijzigingen van de competitie. Noteer de geplande datum, de tijdzone en de datum waarop je het hebt opgezocht samen. De gratis feed kan achterlopen op een wijziging in de uitzending, wat van belang is als iemand zijn zaterdag plant op basis van het antwoord.
Football data provided by the Football-Data.org API. Het gedateerde voorbeeld gebruikt de openbare Native Stats-pagina’s van de provider. Zie de abonnementen en het maximumaantal verzoeken voor de huidige dekking en actualiteit.
Veelgestelde vragen
Welke voetbal-API kan ik gebruiken voor een chatbot voor het wedstrijdschema?
De football-data.org v4-API levert wedstrijdschema’s, uitslagen en ranglijsten voor de competities die worden ondersteund. Gebruik het team-eindpunt voor het schema en de recente vorm, en het competitie-eindpunt voor de positie op de ranglijst.
Zijn de scores van football-data.org live in het gratis abonnement?
Het gratis abonnement omvat vertraagde scores en wedstrijdschema’s, ranglijsten voor ondersteunde competities en een maximum van 10 API-verzoeken per minuut. Vermeld de bron en datum bij elk antwoord en controleer je abonnement als je live scores nodig hebt.
Hoe verander ik Arsenal naar een ander team?
Zoek de team-ID en competitie van de club op in football-data.org. Vervang team 57 in beide wedstrijd-Actions, wijzig het numerieke competitiefilter en de URL voor de ranglijst en werk vervolgens de clubnaam en team-ID in de instructies bij. Test met een wedstrijd die je herkent.
Hoe vraag ik de laatste vijf wedstrijden op vanuit het oogpunt van het team?
Filter op afgeronde competitiewedstrijden binnen een bepaald datumbereik, sorteer op aftrap van nieuw naar oud en neem er maximaal vijf. Controleer voor elke uitslag of je team een thuis- of uitwedstrijd speelde voordat je een winst, gelijkspel of verlies toekent. Als er minder dan vijf wedstrijden voldoen, geef dan aan hoeveel je er hebt gevonden.
Wat betekent een blanco score voor een uitgestelde wedstrijd?
Een blanco score betekent dat de provider geen doelpuntenaantal voor die partij heeft geleverd. Houd de wedstrijdstatus zichtbaar en laat de score onbekend. Een doelpuntloos gelijkspel vereist een afgeronde wedstrijd met twee genoteerde nullen.
Hoe converteer ik een voetbalaftrap naar mijn tijdzone?
Begin met de UTC aftrap van de wedstrijd, gebruik een benoemde tijdzone zoals America/New_York en houd de datum in het antwoord. Zowel zomertijd als een verandering van kalenderdag kunnen de weergegeven tijd beïnvloeden.