Tools en MCP hooks

Deze pagina toont de 8 hooks van deze groep. Elke hook laat zijn type zien, de versie waarin hij verscheen, waar hij draait, zijn argumenten en een beginpunt.

addochat_account_data
addochat_order_by_number
addochat_order_tracking
addochat_page_context
addochat_product_query_args
addochat_tool_called
addochat_tool_result
addochat_tools

addochat_account_data

FilterSinds 0.2.0 Draait in src/Tools/MyAccount.php.

Filtert wat de assistent krijgt over het account van de ingelogde bezoeker. Haal velden weg die je niet naar de AI of de webhook wilt sturen (bijvoorbeeld telefoon of adressen), of voeg eigen velden toe.

Argument	Type	Beschrijving
`$data`	`array<string, mixed>`	Account: name, email, phone, billing, shipping, orders, customer_since.
`$user`	`\WP_User`	De ingelogde klant.

add_filter( 'addochat_account_data', function ( $data, $user ) {
	return $data;
}, 10, 2 );

addochat_order_by_number

FilterSinds 0.1.0 Draait in src/Tools/LookupOrder.php.

Filtert de bestelling bij een bestelnummer. Geef een WC_Order terug als de winkel eigen nummers gebruikt; geef false terug als het nummer geen bestelling van deze winkel is, zodat AddoChat het niet als order-id probeert (eigen nummers kunnen samenvallen met id's van andere bestellingen); laat null staan om de order-id te gebruiken.

Argument	Type	Beschrijving
`$order`	`\WC_Order\|false\|null`	Tot nu toe gevonden order.
`$number`	`string`	Ordernummer zoals de bezoeker het gaf.

add_filter( 'addochat_order_by_number', function ( $order, $number ) {
	return $order;
}, 10, 2 );

addochat_order_tracking

FilterSinds 0.1.0 Draait in src/Tools/LookupOrder.php.

Filtert de track & trace van een order. WooCommerce heeft daar geen standaardplek voor; geef een lijst met vervoerder, code en url uit je verzendplugin terug.

Argument	Type	Beschrijving
`$tracking`	`array<int, array{carrier: string, code: string, url: string}>`	Track & trace, standaard leeg.
`$order`	`\WC_Order`	De order.

add_filter( 'addochat_order_tracking', function ( $tracking, $order ) {
	return $tracking;
}, 10, 2 );

addochat_page_context

FilterSinds 0.2.0 Draait in src/Tools/PageText.php.

Bepaalt de tekst van een pagina die de assistent of een collega leest, bijvoorbeeld om eigen velden toe te voegen of een deel weg te laten. Geef '' terug om niets te geven.

Argument	Type	Beschrijving
`$text`	`string`	Platte tekst van de inhoud, alinea's gescheiden door een lege regel.
`$post`	`\WP_Post`	Het bericht.
`$url`	`string`	Adres waar de bezoeker op is.

add_filter( 'addochat_page_context', function ( $text, $post, $url ) {
	return $text;
}, 10, 3 );

addochat_product_query_args

FilterSinds 0.1.0 Draait in src/Tools/SearchProducts.php.

Filtert de argumenten van wc_get_products() in de tool die producten zoekt.

Argument	Type	Beschrijving
`$args`	`array<string, mixed>`	Zoekargumenten.
`$query`	`string`	Zoekwoorden.
`$context`	`\Addochat\Tools\Context`	Voor wie de aanroep is.

add_filter( 'addochat_product_query_args', function ( $args, $query, $context ) {
	return $args;
}, 10, 3 );

addochat_tool_called

ActionSinds 0.1.0 Draait in src/Tools/Registry.php.

Gaat af nadat een tool heeft gedraaid. Zonder invoer of resultaat: gebruik daarvoor addochat_tool_result.

Argument	Type	Beschrijving
`$name`	`string`	Naam van de tool.
`$context`	`\Addochat\Tools\Context`	Voor wie de aanroep is.
`$ok`	`bool`	Of het gelukt is.
`$duration`	`int`	Milliseconden.

add_action( 'addochat_tool_called', function ( $name, $context, $ok, $duration ) {
	// ...
}, 10, 4 );

addochat_tool_result

FilterSinds 0.1.0 Draait in src/Tools/Registry.php.

Filtert het resultaat van een tool voordat de assistent het ziet.

Argument	Type	Beschrijving
`$result`	`array<string, mixed>`	content (tekst voor het model), data, is_error, en eventueel cards, handoff en refs (sinds 0.2.0: wat de tool gebruikte, als type order\|product\|customer\|page en id) en cart (sinds 0.2.0: producten die voor de winkelwagen worden aangeboden).
`$name`	`string`	Naam van de tool.
`$context`	`\Addochat\Tools\Context`	Voor wie de aanroep is.

add_filter( 'addochat_tool_result', function ( $result, $name, $context ) {
	return $result;
}, 10, 3 );

addochat_tools