Zendesk Request to Twilio Identity Verification

arazzo: 1.0.1
info:
  title: Zendesk Request to Twilio Identity Verification
  summary: Submit a Zendesk end-user request, then start a Twilio verification.
  description: >-
    A cross-provider ITSM workflow that captures an end-user help request in
    Zendesk and starts a Twilio Verify identity verification challenge so the
    requester's contact channel can be confirmed before an agent proceeds.
    Demonstrates orchestrating a support desk with a verification provider in a
    single Arazzo workflow.
  version: 1.0.0
sourceDescriptions:
  - name: zendeskRequests
    url: https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/openapi/zendesk-requests-api-openapi.yml
    type: openapi
  - name: twilioVerify
    url: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-services-api-openapi.yml
    type: openapi
workflows:
  - workflowId: request-to-verify
    summary: Create a Zendesk request, then begin a Twilio verification.
    description: >-
      Creates a Zendesk end-user request and starts a Twilio Verify challenge to
      confirm the requester's phone number before agent triage.
    inputs:
      type: object
      properties:
        subject:
          type: string
        description:
          type: string
        serviceSid:
          type: string
        toNumber:
          type: string
    steps:
      - stepId: create-request
        description: Create a Zendesk end-user request.
        operationId: $sourceDescriptions.zendeskRequests.CreateRequest
        requestBody:
          contentType: application/json
          payload:
            request:
              subject: $inputs.subject
              comment:
                body: $inputs.description
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          requestId: $response.body#/request/id
      - stepId: start-verification
        description: Start a Twilio Verify challenge for the requester.
        operationId: $sourceDescriptions.twilioVerify.CreateVerification
        requestBody:
          contentType: application/x-www-form-urlencoded
          payload:
            ServiceSid: $inputs.serviceSid
            To: $inputs.toNumber
            Channel: sms
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          verificationSid: $response.body#/sid
          verificationStatus: $response.body#/status
    outputs:
      requestId: $steps.create-request.outputs.requestId
      verificationStatus: $steps.start-verification.outputs.verificationStatus