# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Live Direct Marketing Online ICP Extension / API
  version: 1.0.0
extends: openapi/live-direct-marketing-online-icp-extension-api-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 17
- target: $.paths['/api/ext/auth'].get
  update:
    x-apievangelist-phrasing:
      intent: Authorize the Chrome extension with a project key
      effect: read
      questions:
      - How does the Chrome extension get authorized to my project?
      - Is my project key valid for the browser extension?
      instructions:
      - text: Authorize the Chrome extension with project key {key}.
        slots:
          key: query.key
      - text: Check whether extension key {key} is accepted.
        slots:
          key: query.key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/icpreview/next'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the next ICP review item
      effect: read
      questions:
      - Which company is next in my ICP review queue in the extension?
      - Can the extension pull the next ideal-customer-profile item to review?
      instructions:
      - text: Get the next ICP review item for key {key}.
        slots:
          key: query.key
      - text: Pull the next company to review against my ICP using key {key}.
        slots:
          key: query.key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/icpreview/ai'].post
  update:
    x-apievangelist-phrasing:
      intent: Analyze an ICP review item with AI
      effect: write
      questions:
      - Can AI judge whether the company I'm reviewing fits my ideal customer profile?
      - Is there an AI analysis for the current ICP review item?
      instructions:
      - text: Analyze the current ICP review item with AI.
      - text: Have AI score this company against my ideal customer profile.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/icpreview/enrich'].post
  update:
    x-apievangelist-phrasing:
      intent: Enrich a company card from the visited site
      effect: write
      questions:
      - Can the extension fill in a company card from the website I'm on?
      - Is there automatic enrichment of company details while browsing their site?
      instructions:
      - text: Auto-enrich the company card from the site I'm visiting.
      - text: Fill in this company's CRM card using its website.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/icpreview/complete'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark an ICP review item as completed
      effect: write
      questions:
      - How do I finish an ICP review item so the next one appears?
      - Can I record that I'm done reviewing this company?
      instructions:
      - text: Mark the current ICP review item as completed.
      - text: Close out this ICP review and move on.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/formassist/config'].get
  update:
    x-apievangelist-phrasing:
      intent: Get form assist configuration
      effect: read
      questions:
      - What settings does the extension use to help fill in contact forms?
      - Can I load the form assist configuration for my project?
      instructions:
      - text: Get the form assist configuration for key {key}.
        slots:
          key: query.key
      - text: Load the extension's form-fill settings with key {key}.
        slots:
          key: query.key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/company/lookup'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a CRM company by site host
      effect: read
      questions:
      - Is the website I'm on already a company in my CRM?
      - Can the extension widget show the company card for a site host?
      instructions:
      - text: Look up the CRM company for host {host} using key {key}.
        slots:
          host: query.host
          key: query.key
      - text: Show the company card for {host} on task item {task_item_id} and company {company_id} with key {key}.
        slots:
          host: query.host
          task_item_id: query.task_item_id
          company_id: query.company_id
          key: query.key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/formassist/profile'].get
  update:
    x-apievangelist-phrasing:
      intent: Get profile values for manual form fill
      effect: read
      questions:
      - Which saved profile values can I paste into a form from the right-click menu?
      - Can I get my resolved sender details for filling in a site's form by hand?
      instructions:
      - text: Get the resolved form-fill profile for key {key}.
        slots:
          key: query.key
      - text: Load my sender profile values for manual form filling with key {key}.
        slots:
          key: query.key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/formassist/ai'].post
  update:
    x-apievangelist-phrasing:
      intent: Suggest form-fill values with AI
      effect: write
      questions:
      - Can AI suggest what to write in a website's contact form?
      - Is there an AI fill suggestion for the form I'm looking at?
      instructions:
      - text: Run an AI form-fill suggestion for this page.
      - text: Have AI draft the answers for this contact form.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/formassist/complete'].post
  update:
    x-apievangelist-phrasing:
      intent: Report a completed form submission
      effect: write
      questions:
      - How does the extension record that I submitted a form on a company's site?
      - Can I log form-assist completion back to the CRM?
      instructions:
      - text: Report that the form assist submission is complete.
      - text: Log that I filled in this site's contact form.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/sendemail/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the extension's send-email stats
      effect: read
      questions:
      - How many emails have I captured or sent through the extension?
      - What are my send-email numbers in the browser extension?
      instructions:
      - text: Get send-email stats for extension key {key}.
        slots:
          key: query.key
      - text: Show my extension email capture counts with key {key}.
        slots:
          key: query.key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/sendemail/capture'].post
  update:
    x-apievangelist-phrasing:
      intent: Capture an email address from a web page
      effect: write
      questions:
      - Can I save an email address I found on a website into the CRM?
      - How does the extension capture contact emails while browsing?
      instructions:
      - text: Capture this email address from the page.
      - text: Save the email I just found on this site.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/messenger/generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a messenger message
      effect: write
      questions:
      - Can AI write an outreach message for Telegram, WhatsApp, VK or LinkedIn?
      - Which messenger channels can the extension draft messages for?
      instructions:
      - text: Generate a {channel} message for this prospect.
        slots:
          channel: query.channel
      - text: Draft an outreach note to send on {channel}.
        slots:
          channel: query.channel
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/messenger/complete'].post
  update:
    x-apievangelist-phrasing:
      intent: Report a sent messenger message
      effect: write
      questions:
      - Does sending a messenger message create a contact from the profile link?
      - How do I log that I messaged someone on LinkedIn or Telegram?
      instructions:
      - text: Report that the {channel} message was sent and link the contact.
        slots:
          channel: query.channel
      - text: Log my completed {channel} outreach for this profile.
        slots:
          channel: query.channel
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/presentation'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a presentation PDF
      effect: write
      questions:
      - Can the extension build a presentation PDF to attach or share as a link?
      - What's the difference between attach mode and link mode for presentations?
      instructions:
      - text: Generate a presentation PDF as an attachment.
      - text: Create a shareable presentation link for this prospect.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/presentation/pdf/{filename}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a presentation PDF by filename
      effect: read
      questions:
      - Where can a prospect download the presentation PDF I generated?
      - Can I fetch a presentation file by its name without a key?
      instructions:
      - text: Download presentation PDF {filename}.
        slots:
          filename: path.filename
      - text: Serve the public presentation file {filename}.
        slots:
          filename: path.filename
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/ext/presentation/{token}'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the preview page for a presentation link
      effect: read
      questions:
      - What preview card shows up when a presentation link is shared in chat?
      - Can I open the public preview page for a presentation token?
      instructions:
      - text: Open the preview page for presentation token {token}.
        slots:
          token: path.token
      - text: Show the link preview for shared presentation {token}.
        slots:
          token: path.token
      method: generated
      generated: '2026-10-01'