Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.digifist.com/llms.txt

Use this file to discover all available pages before exploring further.

WhatsApp’s Business Platform requires explicit opt-in before any marketing message can be sent to a customer. Galantis enforces this at the platform level — customers without a SUBSCRIBED consent status are automatically excluded from campaign sends and automation message actions before any message reaches the WhatsApp API.

​
What this covers

  • The consent states Galantis tracks per customer
  • How consent is collected
  • Where consent is enforced across the platform
  • How opt-outs are handled
Galantis tracks consent per customer using CustomerMarketingStateEnum. Every customer in your workspace has one of the following states:
StateMeaning
SUBSCRIBEDCustomer has explicitly opted in — safe to send marketing messages
PENDINGConsent collected, awaiting confirmation
NOT_SUBSCRIBEDCustomer has not opted in — cannot receive marketing messages
UNSUBSCRIBEDPreviously opted in, now opted out
UNKNOWNNo consent information available
INVALIDBad or unverifiable data
REDACTEDGDPR or compliance data deletion applied
Only customers with SUBSCRIBED status are included in campaign sends. Automations apply the same validation before dispatching any message action.
Sending marketing messages to customers without explicit opt-in is a violation of WhatsApp’s Business Policy and can result in your phone number receiving a quality downgrade, reduced throughput limits, or suspension. Galantis enforces this automatically, but it is important to understand why the restriction exists.
Galantis supports four collection methods. Each method results in a SUBSCRIBED or PENDING consent state being recorded against the customer’s profile.
An opt-in checkbox presented to the customer during the Shopify checkout flow. When the customer checks the box and completes the order, their consent state is synced into Galantis via the customers/marketing_consent_updated webhook.This is the most common collection method for stores with existing purchase traffic.
Consent validation is applied automatically in three places: Campaigns — The campaign send job filters the final audience to include only customers with marketing_state = SUBSCRIBED. Customers in any other state are excluded from the send, even if they appear in a selected list or segment. Automations — Before an automation’s message action dispatches, Galantis validates the customer’s opt-in status. Customers who are UNSUBSCRIBED or REDACTED are skipped, and the skip is recorded in the automation’s activity log. Back-in-Stock notifications — Restock notifications are sent only to ACTIVE subscribers whose marketing_state is not UNSUBSCRIBED or REDACTED.

​
Handling opt-outs

When a customer replies STOP to any WhatsApp message, their marketing_state is moved to UNSUBSCRIBED immediately. From that point:
  • They are excluded from all campaign sends
  • They are skipped in all automation message actions
  • They will not receive Back-in-Stock notifications
Re-subscription requires explicit new opt-in from the customer — for example, re-submitting through the Back-in-Stock widget or completing the Shopify checkout opt-in checkbox again. Galantis does not provide a mechanism to manually override an UNSUBSCRIBED state back to SUBSCRIBED. A customer’s current marketing_state is visible in Audience → Contacts → [Customer Name]. This is useful when troubleshooting why a specific customer did not receive a campaign or automation message.