> ## Documentation Index
> Fetch the complete documentation index at: https://docs-qa.interactly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing Tools

> Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues

# Testing Your Tools

Use the built-in test runner on the Interactly platform to verify your tool is configured correctly before going live.

<Steps>
  <Step title="Open the Test Panel">
    Navigate to your tool and click the **Test Tool** tab to open the testing interface.

    <Frame caption="Click to start tool testing">
      <img src="https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/test-tool-click.png?fit=max&auto=format&n=Q9JWUuR-E86u3n6L&q=85&s=e2ad435c216b1ac9bed2926cbb04544a" width="2880" height="1496" data-path="images/assistant-tools/test-tool-click.png" />
    </Frame>
  </Step>

  <Step title="Review Tool Details & Fill Parameters">
    You will see a detailed view of your configured tool. Any parameters defined for the tool are listed on the left side — fill in the required values before running the test.

    <Frame caption="Tool details with parameter input fields on the left">
      <img src="https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/view-tool-and-give-params-value.png?fit=max&auto=format&n=Q9JWUuR-E86u3n6L&q=85&s=2b3e4a8603205e5cfc280b628143cb75" width="2880" height="1496" data-path="images/assistant-tools/view-tool-and-give-params-value.png" />
    </Frame>
  </Step>

  <Step title="Run the Test">
    Once all parameters are filled in, click **Run Test** to send a request to your server endpoint.

    <Frame caption="Run test button">
      <img src="https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/run-test.png?fit=max&auto=format&n=Q9JWUuR-E86u3n6L&q=85&s=b1d5366bfa947fb3ff68d7bf164a2672" width="2880" height="1496" data-path="images/assistant-tools/run-test.png" />
    </Frame>
  </Step>

  <Step title="Review the Response">
    Check the response returned by your endpoint.

    <AccordionGroup>
      <Accordion title="Success Response" icon="circle-check">
        A correctly configured tool will return a `200` status with the expected payload from your server.

        <Frame caption="Successful tool response">
          <img src="https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/tool-success-response.png?fit=max&auto=format&n=Q9JWUuR-E86u3n6L&q=85&s=d7a1512097940c2203d381cfd23c5420" width="2880" height="1496" data-path="images/assistant-tools/tool-success-response.png" />
        </Frame>
      </Accordion>

      <Accordion title="Wrong Method Error" icon="triangle-exclamation">
        If your endpoint does not accept the HTTP method being used (e.g., sending `GET` instead of `POST`), you will see a method-not-allowed error like below.

        <Frame caption="Wrong HTTP method configuration">
          <img src="https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result.png?fit=max&auto=format&n=Q9JWUuR-E86u3n6L&q=85&s=76257030ce50989892ace47ac42921b0" width="2880" height="1496" data-path="images/assistant-tools/wrong-configuration-result.png" />
        </Frame>

        **Fix:** Go back to your tool's server configuration and ensure the correct HTTP method (e.g., `POST`) is selected.
      </Accordion>

      <Accordion title="Wrong Authorization Header" icon="lock-open">
        A common mistake is using `authorisation` instead of `authorization` in the header key. This causes authentication to fail.

        <Frame caption="Wrong authorization header spelling">
          <img src="https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result-2.png?fit=max&auto=format&n=Q9JWUuR-E86u3n6L&q=85&s=792b918a48d9d76f8b8774422756f6d0" width="2880" height="1496" data-path="images/assistant-tools/wrong-configuration-result-2.png" />
        </Frame>

        **Fix:** In the **Headers** section of your tool, ensure the key is spelled `authorization` (not `authorisation`).
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>