Overview

Pub/Sub Inbound and Outbound actions enable SnapApp workflows to communicate with external systems using an event-driven architecture.

• Pub/Sub Outbound sends data from SnapApp to an external Pub/Sub topic.
• Pub/Sub Inbound listens to a Pub/Sub topic and triggers workflows when new messages arrive.

This allows SnapApp to integrate seamlessly with analytics pipelines, data platforms, and third-party services that rely on Google Pub/Sub.

Table of Contents

• Overview
• Table of Contents
• Pub/Sub Workflow Actions Explained
• 1. Pub/Sub Outbound Action
• 2. Pub/Sub Inbound Action
• Create a Workflow
• Create an Outbound Action Workflow
• Create an Inbound Action Workflow

Pub/Sub Workflow Actions Explained

1. Pub/Sub Outbound Action

The Pub/Sub Outbound action publishes SnapApp record data to a specified Pub/Sub topic in JSON format.

• Data is sent as key-value pairs, where:
• Keys represent field names
• Values represent the corresponding record values
• The configured service account must have publish permissions for the target Pub/Sub topic.

This action is commonly used when SnapApp needs to: - Notify external systems of record updates - Push data into streaming or analytics pipelines - Trigger downstream services in real time

2. Pub/Sub Inbound Action

The Pub/Sub Inbound action subscribes to a Pub/Sub topic and listens for incoming messages.

Whenever a message is published to the configured topic: - SnapApp receives the event - The associated workflow is triggered automatically - Data is processed in real time

This is ideal for: - Event-driven automation - Syncing data from external systems - Reacting instantly to third-party events

Create a Workflow

Before configuring Pub/Sub actions, you must first create a Workflow that defines the execution logic.

1. Open the Settings page from the User menu in the top bar.

1. From the left navigation panel, go to
   Automation →
   Workflow

1. Click on + Add New in the Workflow list view.

1. Fill in the required workflow details such as name and description, then click Save.

Note: This workflow will later be linked to your Pub/Sub Inbound or Outbound action.

Create an Outbound Action Workflow

Follow these steps to configure a Pub/Sub Outbound action that publishes data from SnapApp.

1. Navigate to Settings from the top bar.

1. Go to Automation → Actions

1. Click on + Add New in the Actions list.

1. Configure the Outbound Action details.

Note: Select Type → Integrations → PubSub Outbound

• Name
  A unique name used to identify this Outbound Action within SnapApp.

• Type
  Select PubSub Outbound.

• Description
  A brief explanation of what this action does.

• PubSub Topic
  The target Pub/Sub topic where data will be published.
  Format:
  projects/{project_id}/topics/{topic_name}
  
  Ensure the service account has permission to publish to this topic.

• Workflow Sequence
  Defines the execution order of this action within the workflow.

• Workflow ID
  Select the previously created workflow to associate with this action.

1. Click Save to complete the configuration.

Create an Inbound Action Workflow

Use the following steps to configure a Pub/Sub Inbound action that listens for incoming messages.

1. Open Settings from the top bar.

1. Navigate to Automation → Actions

1. Click + Add New in the Actions list view.

1. Configure the Inbound Action details.

Note: Select Type → Integrations → PubSub Inbound

• Name
  A unique identifier for the Inbound Action.

• Description
  A short description explaining the purpose of this action.

• Type
  Select PubSub Inbound.

• PubSub Topic
  The Pub/Sub topic from which SnapApp will receive messages.
  Format:
  projects/{project_id}/topics/{topic_name}

• Workflow Sequence
  Determines the order of execution in the workflow.

• Workflow ID
  Select the workflow that should be triggered when messages are received.

1. Click Save to finalize the configuration.

Thank you for following these steps to configure your SnapApp components effectively. If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. We’re here to help you make the most out of your SnapApp experience.

For support, email us at snapapp@bluevector.ai