Zum Hauptinhalt springen

Settings & Configuration

The Settings page allows you to configure auto-deactivation rules and Slack notifications for the Datora Bulk Gift Cards app.

Accessing Settings​

  1. Open the Datora Bulk Gift Cards app
  2. Click on Settings in the navigation menu
  3. Make changes as needed
  4. Click Save to apply changes

Auto-Deactivation (Premium+)​

Auto-deactivation automatically deactivates every gift card in a job once the job reaches a specified age. This is useful for cleaning up older campaigns or limiting the lifetime of promotional gift card batches.

Availability: Premium and Ultimate plans only.

How It Works​

  1. Enable auto-deactivation: Toggle the setting on
  2. Set the number of days: Choose how many days after job creation the cards in that job should be automatically deactivated (e.g., 30, 60, 90 days)
  3. The system periodically checks for eligible jobs and deactivates all gift cards in them

What Gets Deactivated​

  • Every gift card in any job older than the configured threshold
  • This includes cards that customers have already partially or fully redeemed — cards with a remaining balance lose access to those funds
  • The check is based on the number of days since the job was created, not per-card activity

Important Notes​

  • Deactivation is permanent: Once a gift card is deactivated, it cannot be reactivated. This action cannot be undone.
  • Affects redeemed and unredeemed cards alike: Choose your threshold carefully — customers holding partially-used cards will lose any remaining balance.
  • Does NOT free up quota: Deactivating gift cards does not free up your monthly plan quota. All created cards count toward the quota regardless of their status.
  • Applies to all jobs: The auto-deactivation rule applies to every gift card creation job in the shop, not just specific jobs.

Configuration​

  1. Navigate to Settings
  2. Find the Auto-Deactivation section
  3. Toggle Enable Auto-Deactivation on
  4. Enter the number of days after job creation to deactivate the cards
  5. Click Save

Example: Setting the value to 90 days means every gift card from a job created more than 90 days ago will be automatically deactivated, regardless of whether it has been used.

Slack Notifications (Premium+)​

Receive real-time notifications in your Slack workspace when gift card jobs complete or fail. Each notification includes a direct link to view the job in your Shopify admin.

Availability: Premium and Ultimate plans only.

Setting Up Slack Notifications​

Step 1: Create a Slack App​

  1. Go to https://api.slack.com/apps and sign in to your Slack workspace
  2. Click Create New App
  3. Choose From scratch
  4. Give the app a name (e.g., "Datora Gift Cards") and select the workspace where you want notifications
  5. Click Create App

Step 2: Configure the Bot User​

Before you can install the app to your workspace, you need to set up a bot user:

  1. In the left sidebar, click App Home
  2. Under Your App's Presence in Slack, click Edit next to "App Display Name"
  3. Set a Display Name (e.g., Datora Gift Cards)
  4. Set a Default Username (e.g., datora-gift-cards)
  5. Click Save

Important: If you skip this step, you will see a "doesn't have a bot user to install" error when trying to add the webhook to your workspace.

Step 3: Enable Incoming Webhooks​

  1. In the left sidebar, click Incoming Webhooks
  2. Toggle Activate Incoming Webhooks to On
  3. Scroll down and click Add New Webhook to Workspace
  4. Select the channel where you want to receive notifications (e.g., #gift-cards or #notifications)
  5. Click Allow
  6. Copy the generated webhook URL — it will look like: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Important: Keep your webhook URL private. Anyone with the URL can post messages to your Slack channel.

Step 4: Configure in the App​

  1. Open the Datora Bulk Gift Cards app in your Shopify admin
  2. Navigate to Settings
  3. Find the Slack Notifications section
  4. Toggle Slack notifications on
  5. Paste your webhook URL into the Webhook URL field

Note: The URL must start with https://hooks.slack.com/. Other URLs will be rejected.

  1. Click Save to store the webhook URL
  2. Click Test to send a test notification to your Slack channel
  3. Verify the test message appears in Slack — you should see:
    • A green checkmark with "Test notification from Datora Bulk Gift Cards"
    • Confirmation that your webhook is working correctly

Note: You must save the webhook URL before testing. The test button uses the saved URL.

What Notifications Look Like​

Notifications are sent automatically whenever a gift card job finishes. The format depends on the job type and outcome:

Successful Creation Job​

✅ Job #A1B2C3D4 completed
50 gift cards created • 25.00 USD each • 1250.00 USD total
[View job in Shopify Admin]

Successful Deactivation Job​

✅ Job #E5F6G7H8 completed
30 gift cards deactivated
[View job in Shopify Admin]

Failed Job​

❌ Job #A1B2C3D4 failed
Error message describing what went wrong
[View job in Shopify Admin]

Each notification includes a View job in Shopify Admin button that links directly to the job details page in your store.

When Notifications Are Sent​

EventNotification
Gift card creation job completedCard count, value per card, total value, currency
Gift card deactivation job completedNumber of cards deactivated
Any job failedError message with job details

Notifications are not sent for:

  • Jobs that are queued or in progress
  • Jobs that are cancelled by the user

Disabling Slack Notifications​

To stop receiving Slack notifications:

  1. Navigate to Settings
  2. Toggle Slack notifications off
  3. Click Save

Your webhook URL is removed from the system. To re-enable later, you'll need to enter the webhook URL again.

Troubleshooting Slack Notifications​

Test message not arriving:

  1. Verify the webhook URL starts with https://hooks.slack.com/
  2. Make sure you clicked Save before clicking Test
  3. Check that the Slack app is still installed in your workspace
  4. Ensure the webhook is configured for the correct channel
  5. Check that the channel still exists and hasn't been archived
  6. Try creating a new webhook URL in your Slack app settings

Notifications stopped working:

  1. Go to https://api.slack.com/apps and check if your app is still active
  2. Verify the webhook hasn't been revoked or regenerated
  3. Check if the Slack app was removed from your workspace
  4. Re-enter the webhook URL in the app settings, save, and test again

"Doesn't have a bot user to install" error:

  • Go to your Slack app settings → App Home
  • Click Edit next to "App Display Name"
  • Set a Display Name and Default Username, then click Save
  • Go back to Incoming Webhooks and try Add New Webhook to Workspace again

"Slack notifications require the Premium or Ultimate plan" error:

  • Slack notifications are only available on Premium ($39.95/mo) and Ultimate ($99.95/mo) plans
  • Upgrade your plan in the Subscriptions page to enable this feature

Need Help?​

Next Steps​