Interactions & Leads

Add Video Interaction With Your AI Assistant

Adds an interactive element at a chosen timestamp: a poll, quiz, question, rating, free-text prompt, or a call-to-action or lead form.

add_interaction Asks to Confirm Plan-Gated Interactions & Leads
Try Asking
“Add a quick poll at the two-minute mark asking which feature they'd use most”

How It Behaves

Has an irreversible path, so it is marked destructive and your assistant asks before it runs. The irreversible path: a CTA is a one-per-video upsert, so adding one replaces the live CTA (polls and quizzes stack instead).

Parameters

NameTypeDescription
video_idRequiredType: stringThe video's guid.
kindRequiredType: "poll" | "quiz" | "question" | "rating" | "free_text" | "cta" | "lead_form"The interaction kind: poll, quiz, question, rating, free_text, cta, or lead_form.
time_secondsRequiredType: numberWhen to show it, in seconds from the video start.
promptType: stringThe question/prompt text (poll, quiz, question, rating, free_text, lead_form).
optionsType: string[]Answer options for a poll or quiz (2 or more).
correct_optionType: integerFor a quiz: the 0-based index into options of the correct answer.
cta_labelType: stringFor a cta: the button label. Defaults to 'Learn more'.
cta_urlType: stringFor a cta: the destination URL the button opens.
requiredType: booleanWhether the viewer must respond before continuing. Default false.

You don’t fill these in yourself. Your assistant reads the schema and passes the values from your request.

Description Sent to AI Assistants

Add an interactive element to a video at a given timestamp. Supported kinds: 'poll' and 'quiz' (need 2+ options; quiz also takes correct_option), 'question', 'rating', 'free_text' (use prompt), 'cta' (call-to-action button — needs cta_url, optional cta_label), and 'lead_form' (capture viewer contact details). NOTE: polls/quizzes/questions/ratings/free-text are added (a video can have many); 'cta' and 'lead_form' are single-per-video and REPLACE any existing one. Plan-gated: returns upgrade_required if the account's plan doesn't include interactions/CTAs. Use the video guid from search_videos/get_video.

Known Limitations

  • A CTA and a lead form are single-per-video upserts: adding one REPLACES the one already live. Polls and quizzes stack instead.
  • Only lead forms capture identities. Poll and quiz results are aggregate counts.

Used in These Prompts

Sales Playbook

Send a Branded Video Pitch with a CTA

Take my product walkthrough link, add a title card that says "Prospect, here's your 3-minute tour", set a "Book a call" button near the end (it replaces any existing button), and give me a one-click share link to send.

  1. add_text_overlay
  2. add_interaction
  3. create_share_link

You GetA personalized, CTA-ready pitch and a no-login link to paste into your email.

Open in
Sales Playbook

Capture Leads from a Public Demo

On my public demo video link, add a short lead-capture form at the start asking for name and work email, then list everyone who's submitted it so far.

  1. add_interaction
  2. list_captured_leads

You GetA demo that quietly builds pipeline, plus the captured lead list on demand.

Open in
Success & Support Playbook

Gather Feedback Right Inside a Video

Add a quick "Was this helpful?" rating and a one-question poll at the end of link, then show me the response counts so far.

  1. add_interaction
  2. get_form_responses

You GetIn-video feedback that tells you which resources are actually landing.

Open in

Good to Know

Does add_interaction Change Anything in My Dadan Account?

Has an irreversible path, so it is marked destructive and your assistant asks before it runs. The irreversible path: a CTA is a one-per-video upsert, so adding one replaces the live CTA (polls and quizzes stack instead).

Does add_interaction Use AI Credits?

No. It does not spend AI credits.

How Do I Use add_interaction?

Connect Dadan to your assistant (setup guides) and ask in plain language, for example: “Add a quick poll at the two-minute mark asking which feature they'd use most”. You never type the tool name; your assistant picks it.

Free to Connect

Give Your Assistant Your Video Library

One URL and one sign-in with the Dadan account you already use. No API key, no client secret, nothing to install.

https://mcp.dadan.io/mcp