ServiceNow Catalog Order to SMS Confirmation

arazzo: 1.0.1
info:
  title: ServiceNow Catalog Order to SMS Confirmation
  summary: Order a ServiceNow catalog item, then text the requester a confirmation.
  description: >-
    A cross-provider ITSM workflow that submits a ServiceNow Service Catalog order
    for a requested item and texts the requester an order confirmation through the
    Twilio Messaging API. Demonstrates orchestrating an enterprise service catalog
    with a programmable SMS provider in a single Arazzo workflow.
  version: 1.0.0
sourceDescriptions:
  - name: servicenowCatalog
    url: https://raw.githubusercontent.com/api-evangelist/servicenow/refs/heads/main/openapi/servicenow-service-catalog-api-openapi.yml
    type: openapi
  - name: twilioMessaging
    url: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-messaging-openapi.yml
    type: openapi
workflows:
  - workflowId: catalog-order-sms
    summary: Order a catalog item, then send an SMS confirmation.
    description: >-
      Submits a ServiceNow Service Catalog order for the given item and sends the
      requester an SMS order confirmation via the Twilio Messaging API.
    inputs:
      type: object
      properties:
        catalogItemSysId:
          type: string
        quantity:
          type: string
        accountSid:
          type: string
        fromNumber:
          type: string
        toNumber:
          type: string
    steps:
      - stepId: order-item
        description: Submit a ServiceNow Service Catalog order for the item.
        operationId: $sourceDescriptions.servicenowCatalog.orderItemNow
        parameters:
          - name: sys_id
            in: path
            value: $inputs.catalogItemSysId
        requestBody:
          contentType: application/json
          payload:
            sysparm_quantity: $inputs.quantity
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          requestNumber: $response.body#/result/request_number
          requestId: $response.body#/result/request_id
      - stepId: confirm-sms
        description: Text the requester an order confirmation via Twilio.
        operationId: $sourceDescriptions.twilioMessaging.createMessage
        requestBody:
          contentType: application/x-www-form-urlencoded
          payload:
            AccountSid: $inputs.accountSid
            From: $inputs.fromNumber
            To: $inputs.toNumber
            Body: Your catalog request has been submitted and is being fulfilled.
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          messageSid: $response.body#/sid
    outputs:
      requestNumber: $steps.order-item.outputs.requestNumber
      messageSid: $steps.confirm-sms.outputs.messageSid