Zendesk Create Macro and Preview on Ticket

arazzo: 1.0.1
info:
  title: Zendesk Create Macro and Preview on Ticket
  summary: Create a macro, then preview the changes it would make to a sample ticket.
  description: >-
    A macro authoring-and-validation pattern for Zendesk Support. The workflow
    creates a macro with the supplied title and actions, captures its id, and
    then requests a preview of the changes that macro would make to a sample
    ticket without persisting them. The create body uses the documented
    {macro:{...}} envelope and is spelled out inline.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-430
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-430
      capability_name: Customer Service Management
      spec: zendesk-macros-api-openapi.yml
      confidence: 0.7
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: macrosApi
  url: ../openapi/zendesk-macros-api-openapi.yml
  type: openapi
workflows:
- workflowId: create-macro-and-preview
  summary: Create a macro and preview its effect on a sample ticket.
  description: >-
    Creates a macro, then dry-runs it against a sample ticket to confirm the
    changes it would produce.
  inputs:
    type: object
    required:
    - title
    - actions
    - sampleTicketId
    properties:
      title:
        type: string
        description: The title of the macro to create.
      actions:
        type: array
        description: >-
          The macro actions, each an object with field and value, e.g.
          [{"field":"status","value":"solved"}].
        items:
          type: object
      sampleTicketId:
        type: integer
        description: The id of a ticket to preview the macro against.
  steps:
  - stepId: createMacro
    description: Create the macro from the supplied title and actions.
    operationId: CreateMacro
    requestBody:
      contentType: application/json
      payload:
        macro:
          title: $inputs.title
          actions: $inputs.actions
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      macroId: $response.body#/macro/id
  - stepId: previewOnTicket
    description: >-
      Preview the changes the new macro would make to the sample ticket without
      persisting them.
    operationId: ShowTicketAfterChanges
    parameters:
    - name: ticket_id
      in: path
      value: $inputs.sampleTicketId
    - name: macro_id
      in: path
      value: $steps.createMacro.outputs.macroId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      proposedStatus: $response.body#/result/ticket/status
      proposedComment: $response.body#/result/ticket/comment/body
  outputs:
    macroId: $steps.createMacro.outputs.macroId
    proposedStatus: $steps.previewOnTicket.outputs.proposedStatus