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 unredeemed gift cards after a specified number of days. This is useful for expiring promotional gift cards that were never used.

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 creation a gift card should be automatically deactivated (e.g., 30, 60, 90 days)
  3. The system checks for eligible gift cards and deactivates any that meet the criteria

What Gets Deactivated​

  • Only gift cards with their full balance remaining (unredeemed) are deactivated
  • Partially redeemed gift cards are never auto-deactivated
  • The check is based on the number of days since the gift card was created

Important Notes​

  • Deactivation is permanent: Once a gift card is deactivated, it cannot be reactivated. This action cannot be undone.
  • 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 gift cards: The auto-deactivation rule applies to all gift cards created through the app, 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 creation to deactivate unredeemed cards
  5. Click Save

Example: Setting the value to 90 days means any gift card created more than 90 days ago that still has its full balance will be automatically deactivated.

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: Enable Incoming Webhooks​

  1. In your new Slack app's settings, navigate to Incoming Webhooks in the left sidebar
  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 3: 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

"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​