{"id":43,"date":"2026-09-09T04:25:58","date_gmt":"2026-09-09T04:25:58","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/43\/action-hooks\/"},"modified":"2026-09-09T04:25:58","modified_gmt":"2026-09-09T04:25:58","slug":"action-hooks","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/developers\/action-hooks\/","title":{"rendered":"Action hooks reference"},"content":{"rendered":"

NiroHelp fires actions at every meaningful moment in a doc’s or a ticket’s
\nlife. Hook them to post to Slack, log to your own table, sync to a CRM, or
\nanything else.<\/p>\n

Note the naming is inconsistent by history: most ticket hooks use hyphens
\n(nirohelp-tickets-\u2026<\/code>), two use underscores (nirohelp_tickets_comment_added<\/code>,
\nnirohelp_user_inserted<\/code>). Copy the names exactly as written.<\/p>\n

Tickets<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Hook<\/th>\nArgs<\/th>\nFired when<\/th>\n<\/tr>\n<\/thead>\n
nirohelp-tickets-ticket_created<\/code><\/td>\n$ticket<\/code><\/td>\nA ticket is created \u2014 front-end form, embed widget or POST \/tickets\/<\/code>.<\/td>\n<\/tr>\n
nirohelp-tickets-client_commented<\/code><\/td>\n$ticket<\/code><\/td>\nA client posts a comment.<\/td>\n<\/tr>\n
nirohelp-tickets-agent_commented<\/code><\/td>\n$ticket<\/code><\/td>\nAn agent posts a comment.<\/td>\n<\/tr>\n
nirohelp-tickets-ticket_status_changed<\/code><\/td>\n$new, $old, $ticket<\/code><\/td>\nThe status changed, and both<\/strong> statuses are registered NiroHelp statuses.<\/td>\n<\/tr>\n
nirohelp-tickets-ticket_status_{new}_to_{old}<\/code><\/td>\n$ticket<\/code><\/td>\nSame event, dynamic name. Note the order \u2014 new first, old second.<\/td>\n<\/tr>\n
nirohelp-tickets-agent_changed<\/code><\/td>\n$new_agent_id, $old_agent_id<\/code><\/td>\nThe assigned agent changed.<\/td>\n<\/tr>\n
nirohelp_tickets_comment_added<\/code><\/td>\n$comment_id, $ticket_id<\/code><\/td>\nLow-level; fires inside the model before the role-specific hooks.<\/td>\n<\/tr>\n
nirohelp-tickets-ticket_model_status_changed<\/code><\/td>\n(none)<\/td>\nInternal; fires in the Ticket model right after a status is set.<\/td>\n<\/tr>\n
nirohelp-tickets-login<\/code><\/td>\n(none)<\/td>\nFired by the four ticket views when the visitor is logged out. Front::show_login_form()<\/code> listens on it. Hook it to render your own login UI.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Because nirohelp-tickets-ticket_status_changed<\/code> requires both statuses to be
\nregistered, moving a ticket to Trash<\/strong> does not fire it \u2014 trash<\/code> is not one
\nof NiroHelp’s statuses. That is deliberate: it stops a deletion sending
\n“resolved” emails and adding a bot note.<\/p>\n

Auth and users<\/h2>\n\n\n\n\n\n\n\n\n\n
Hook<\/th>\nArgs<\/th>\nFired when<\/th>\n<\/tr>\n<\/thead>\n
nirohelp-tickets-code_generated<\/code><\/td>\n$email, $code<\/code><\/td>\nA 6-digit login code was generated. Controllers\\Common\\Email<\/code> listens and sends it.<\/td>\n<\/tr>\n
nirohelp-tickets-magic_link_sent<\/code><\/td>\n$email, $link<\/code><\/td>\nA one-click login link was minted, in magic_link<\/code> mode. Same listener.<\/td>\n<\/tr>\n
nirohelp-tickets-user_found<\/code><\/td>\n$data<\/code><\/td>\nAn existing user was matched during login.<\/td>\n<\/tr>\n
nirohelp-logged_in<\/code><\/td>\n$user_id<\/code><\/td>\nA client was signed in through the ?nirohelplogin={key}<\/code> flow.<\/td>\n<\/tr>\n
nirohelp_user_inserted<\/code><\/td>\n$user_id<\/code><\/td>\nA new NiroHelp client account was created.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Docs<\/h2>\n\n\n\n\n\n\n\n
Hook<\/th>\nArgs<\/th>\nFired when<\/th>\n<\/tr>\n<\/thead>\n
nirohelp-doc_created<\/code><\/td>\n$doc<\/code><\/td>\nA doc is created through POST \/docs\/<\/code>.<\/td>\n<\/tr>\n
nirohelp-before_doc_content<\/code><\/td>\n$doc<\/code><\/td>\nInside the single-doc template, before the post body.<\/td>\n<\/tr>\n
nirohelp-after_doc_content<\/code><\/td>\n$doc<\/code><\/td>\nInside the single-doc template, after the post body. The plugin’s own pagination and rating buttons hang off this.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

AI<\/h2>\n\n\n\n\n\n\n
Hook<\/th>\nArgs<\/th>\nFired when<\/th>\n<\/tr>\n<\/thead>\n
nirohelp_ai_auto_respond<\/code><\/td>\n$ticket_id<\/code><\/td>\nThe auto-responder WP-Cron event. One argument. Unhook the plugin’s callback and add your own to keep the scheduling and cancellation while writing the reply yourself.<\/td>\n<\/tr>\n
nirohelp_daily_briefing<\/code><\/td>\n(none)<\/td>\nThe daily briefing cron event, scheduled for 06:00 site time.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

A practical example<\/h2>\n

Post to Slack whenever a Severe<\/em> ticket lands:<\/p>\n

add_action( 'nirohelp-tickets-ticket_created', function ( $ticket ) {\n    if ( 'severe' !== $ticket->get_meta( 'urgency' ) ) {\n        return;\n    }\n\n    wp_remote_post( 'https:\/\/hooks.slack.com\/...', [\n        'headers' => [ 'Content-Type' => 'application\/json' ],\n        'body'    => wp_json_encode( [\n            'text' => sprintf( 'New severe ticket: %s', $ticket->get_title() ),\n        ] ),\n    ] );\n} );\n<\/code><\/pre>\n
And to react only to a specific transition:<\/p>\n
\/\/ A ticket that was Resolved and is now Reopened.\nadd_action( 'nirohelp-tickets-ticket_status_reopened_to_resolved', function ( $ticket ) {\n    \/\/ ...\n} );\n<\/code><\/pre>\n","protected":false},"author":1,"featured_media":0,"template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"nirohelp_product":[],"nirohelp_topic":[12],"class_list":["post-43","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-developers"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/43","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc"}],"about":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/types\/nirohelp_doc"}],"author":[{"embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/media?parent=43"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=43"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=43"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}