TikTok Creator Info to Airtable Log and Slack Notify

arazzo: 1.0.1
info:
  title: TikTok Creator Info to Airtable Log and Slack Notify
  summary: Query a TikTok creator's posting info, log it to Airtable, then notify a Slack channel.
  description: >-
    A social content workflow that pulls a TikTok creator's current posting
    eligibility and profile info via the Content Posting API, records a row in an
    Airtable content-tracking base, and posts a confirmation message to a Slack
    channel. Demonstrates orchestrating a social platform, a database provider,
    and a messaging provider in a single Arazzo workflow.
  version: 1.0.0
sourceDescriptions:
  - name: tiktokContentApi
    url: https://raw.githubusercontent.com/api-evangelist/tiktok-for-developers/refs/heads/main/openapi/tiktok-for-developers-post-api-openapi.yml
    type: openapi
  - name: airtableApi
    url: https://raw.githubusercontent.com/api-evangelist/airtable/refs/heads/main/openapi/airtable-records-api-openapi.yml
    type: openapi
  - name: slackChatApi
    url: https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/openapi/slack-chat-api-openapi.yml
    type: openapi
workflows:
  - workflowId: creator-info-to-airtable-and-slack
    summary: Query TikTok creator info, log to Airtable, notify Slack.
    description: >-
      Calls TikTok queryCreatorInfo to fetch the creator's posting capabilities,
      writes the result to an Airtable base, then posts a Slack message linking
      the new Airtable record.
    inputs:
      type: object
      properties:
        baseId:
          type: string
        tableIdOrName:
          type: string
        slackChannel:
          type: string
    steps:
      - stepId: query-creator
        description: Fetch the TikTok creator's posting info and capabilities.
        operationId: $sourceDescriptions.tiktokContentApi.queryCreatorInfo
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          creatorNickname: $response.body#/data/creator_nickname
          creatorUsername: $response.body#/data/creator_username
      - stepId: log-to-airtable
        description: Record the creator info as a new row in the Airtable base.
        operationId: $sourceDescriptions.airtableApi.createRecords
        requestBody:
          contentType: application/json
          payload:
            records:
              - fields:
                  Nickname: $steps.query-creator.outputs.creatorNickname
                  Username: $steps.query-creator.outputs.creatorUsername
                  Source: TikTok
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          recordId: $response.body#/records/0/id
      - stepId: notify-slack
        description: Post a Slack message confirming the new Airtable record.
        operationId: $sourceDescriptions.slackChatApi.postChatPostmessage
        requestBody:
          contentType: application/x-www-form-urlencoded
          payload:
            channel: $inputs.slackChannel
            text: Logged TikTok creator to Airtable record $steps.log-to-airtable.outputs.recordId
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          messageTs: $response.body#/ts
    outputs:
      creatorNickname: $steps.query-creator.outputs.creatorNickname
      recordId: $steps.log-to-airtable.outputs.recordId
      messageTs: $steps.notify-slack.outputs.messageTs