# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Messaging Alpha Senders API
  version: 1.0.0
extends: openapi/twilio-alpha-senders-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/Services/{ServiceSid}/AlphaSenders'].get
  update:
    x-apievangelist-phrasing:
      intent: List alphanumeric sender IDs on a Messaging Service
      effect: read
      questions:
      - Which alphanumeric sender IDs are attached to my Messaging Service?
      - Can I see the brand names my service sends SMS from?
      instructions:
      - text: List the alpha sender IDs on Messaging Service {service}.
        slots:
          service: path.ServiceSid
      - text: Show which alphanumeric senders service {service} uses.
        slots:
          service: path.ServiceSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services/{ServiceSid}/AlphaSenders'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an alphanumeric sender ID to a Messaging Service
      effect: write
      questions:
      - How do I send SMS that shows my brand name instead of a phone number?
      - What is the character limit for an alphanumeric sender ID?
      instructions:
      - text: Add alpha sender {sender} to Messaging Service {service}.
        slots:
          sender: requestBody.AlphaSender
          service: path.ServiceSid
      - text: Let service {service} send messages as {sender}.
        slots:
          service: path.ServiceSid
          sender: requestBody.AlphaSender
      method: generated
      generated: '2026-09-26'