> ## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.