> ## Documentation Index
> Fetch the complete documentation index at: https://tools.lunchpaillabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Start bot

Start a PailFlow AI bot inside a Daily room using the Video, Audio & Live Streaming bundle.

## Fields

Use the **Bundle PailFlow - Start bot** action in your Bubble workflow and configure the fields below.

| Field                | Type     | Required | Description                                                                                                                                                                                                                                                                                                                                  |
| -------------------- | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| room url             | Text     | Yes      | The complete meeting room link you want the bot to join.                                                                                                                                                                                                                                                                                     |
| bot prompt           | Text     | Yes      | Main instruction the bot should follow when joining the room.                                                                                                                                                                                                                                                                                |
| bot greeting         | Text     | Optional | Custom greeting message appended to the default introduction. If not provided, only the default introduction is used.                                                                                                                                                                                                                        |
| stop phrase          | Text     | Optional | Triggers force-leave when the assistant says it (case-insensitive). For best results, use phrases without punctuation like "have a nice day" or "goodbye friend". Punctuation (especially apostrophes) may cause inconsistent detection. Does not trigger on user speech.                                                                    |
| name                 | Text     | Optional | Friendly identifier shown wherever the bot appears.                                                                                                                                                                                                                                                                                          |
| token                | Text     | Optional | Meeting token for private rooms that require an access token.                                                                                                                                                                                                                                                                                |
| provider             | Dropdown | Yes      | Video provider name. Defaults to `daily`.                                                                                                                                                                                                                                                                                                    |
| voice                | Dropdown | Optional | Voice for the bot's TTS (text-to-speech). Uses OpenAI's realtime API. Options: alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse. Defaults to `echo`.                                                                                                                                                                 |
| bot image            | Text     | Optional | URL to a custom background image for the bot's video feed. Supports PNG and JPG/JPEG formats. Transparent PNGs are automatically converted to RGB with a white background. When set, forces static mode regardless of video\_mode. Must be an absolute HTTPS URL. Recommended: 16:9 aspect ratio (1280x720 pixels). Maximum file size: 5 MB. |
| webhook callback url | Text     | Optional | Webhook endpoint that receives the bot's summaries and results. See [PailFlow webhooks](/pailflow/webhooks) for payload details.                                                                                                                                                                                                             |

## Returned values

| Output        | Type    | Description                                  |
| ------------- | ------- | -------------------------------------------- |
| error         | Boolean | Indicates whether the API call failed.       |
| error message | Text    | Details returned when an error occurs.       |
| error status  | Number  | HTTP status code for failed requests.        |
| status        | Text    | Overall request status reported by the API.  |
| bot\_id       | Text    | Identifier for the bot that joined the room. |
| room\_url     | Text    | Echo of the room URL used for the request.   |

<CardGroup cols={2}>
  <Card title="Need Help?" icon="envelope" href="/support/plans">
    View our options for free community and priority support.
  </Card>

  <Card title="Have a feature request?" icon="lightbulb" href="https://lunchpaillabs.canny.io/feature-requests?selectedCategory=bubble-video-audio-live">
    Post your feature request on our

    <a href="https://lunchpaillabs.canny.io/feature-requests?selectedCategory=bubble-video-audio-live">
      idea board.
    </a>
  </Card>
</CardGroup>