Skip to content
Powsoo

Quickstart

Get a live powsoo_show_card call firing in a real Retell conversation.

Prerequisites

  1. Connect your Retell account

    In the Powsoo dashboard, go to Voice platforms → Connect Retell. Paste your Retell API key (from Retell’s API Keys page). Powsoo AES-GCM-encrypts it immediately — the plaintext never persists.

  2. Create a widget

    Go to Widgets → New widget. Pick the Retell account, then the agent. Name the widget.

    Under Allowed origins, add your site’s domain (e.g. example.com). For local testing, localhost is always allowed without configuration.

  3. Add powsoo_show_card to your Retell agent

    In Retell, open your agent → Functions → Add custom function. Set the type to Server-side and paste the definition from Cards / tool reference.

    Set the URL to:

    https://api.powsoo.com/v1/retell/tools/show-card

    Set both speak_during_execution and speak_after_execution to false — the agent should pause silently while the user looks at the card.

  4. Add the system prompt snippet

    Append the system prompt template to your agent’s prompt. The minimum:

    Use powsoo_show_card whenever the user should confirm a value (email, phone,
    address, name) or choose from a list. Never ask them to spell it back.
    The tool pauses you until the user taps. Accept edited values as canonical.

  5. Paste the embed snippet

    Copy the snippet from the widget’s detail page in the dashboard, or build it manually with your wid_* ID:

    <powsoo-voice widget-id="wid_YOUR_ID_HERE"></powsoo-voice>
    <script>
      (() => {
        const d = document, s = d.createElement('script');
        s.type = 'module';
        s.src = 'https://w.powsoo.com/widget.js';
        d.head.append(s);
      })();
    </script>

    Paste anywhere in <body>. The call button appears where the element sits in the DOM.

  6. Test it

    Open the page, click the call button, and talk to the agent. When the agent calls powsoo_show_card a card should appear on screen. Tap Confirm — the agent should continue.

    Not working? See Troubleshooting.

What’s next