kimaai_chatbot_rate_limited

When it fires

When a chatbot request or a search answer finds today’s count of answered messages from the visitor’s address at the daily limit or above it. The visitor gets an error with status 400 that asks them to come back tomorrow; the action fires before that error is returned, and nothing reaches the AI provider.

It fires for every refused message, so a visitor who keeps trying fires it again and again. The IP address is personal data: keep it out of emails and logs you do not need it in.

Parameters

NameTypeDescription
user_ipstringThe visitor’s IP address, as KimaAI resolves it (see kimaai_trusted_proxies).
today_message_countintThe answered messages from this address today.
max_messagesintThe daily limit, after kimaai_chatbot_daily_message_limit.
payloadarrayThe normalised request payload, with prompt, postId, postSection, lang, sessionId and chatbot_settings, and assistantSurface in a search answer.
chatbot_settingsarrayThe chatbot settings.

Example

add_action(
  'kimaai_chatbot_rate_limited',
  function (string $user_ip, int $today_message_count, int $max_messages): void {
    // One email a day is enough.
    if (get_transient('my_chatbot_limit_mail')) {
      return;
    }
    set_transient('my_chatbot_limit_mail', 1, DAY_IN_SECONDS);

    wp_mail(
      get_option('admin_email'),
      'A visitor reached the chatbot limit',
      sprintf('A visitor sent %d messages today and reached the limit of %d.', $today_message_count, $max_messages)
    );
  },
  10,
  3
);
  • kimaai_chatbot_daily_message_limit: sets the limit.
  • kimaai_chatbot_blocked: fires when the gate refuses a message.

What are your feelings