Skip to main content

Blackleaf Help Centre

Blackleaf Texting FAQ

This English (India) edition answers questions about Blackleaf Texting for regulated retailers. Blackleaf supports messaging programmes in the United States and Canada. The Pricing page lists US plans and rates in US dollars (USD).

Compliance information is general guidance and does not replace legal advice. Requirements vary by jurisdiction, sender, content and use case.

120 answers

overview

Platform overview

What Blackleaf is and where to get account-specific help.

What is Blackleaf?

Short answer Blackleaf is a customer messaging platform for regulated retailers. It combines SMS/MMS campaigns, automations, two-way messaging, audience management, landing pages, reporting, and content tools.

Who is Blackleaf for?

Short answer Blackleaf is designed primarily for dispensaries and other regulated retailers that need consent-based customer messaging at scale.

Where does Blackleaf support messaging?

Short answer Blackleaf supports messaging programs in the United States and Canada. Sender types, registration, content rules, and carrier behavior depend on destination and account configuration.

Ask Support before planning traffic outside your account’s approved destinations.

What can I do in Blackleaf?

Short answer Core tools include contacts and lists, one-time and automated campaigns, SMS/MMS, landing pages, a shared inbox, reporting, AI-assisted images, integrations, billing, numbers, and account settings.

getting-started

Getting started

What is needed before a first send.

Why is my account or campaign under review?

Short answer Unverified or newly configured programs may be reviewed before sending. Review can cover business identity, registration, consent flow, sender setup, and content.

A review is not a delivery guarantee; carriers make independent filtering and delivery decisions.

How do I get help?

Short answer Open Support in the platform or use the public Support page. For a delivery issue, include the affected store, approximate time and time zone, and the status or error. Add the message ID if available. Keep customer phone numbers, message contents, passwords and API keys out of the public form.

Can multiple team members use Blackleaf?

Short answer Yes. Account administrators can manage users. Limit access to people who need it and give each person their own credentials.

Should I send a test before launching?

Short answer Yes. A test helps confirm the rendered body, variables, image, link, sender, and handset experience. A successful test does not guarantee delivery to every recipient.

contacts

Contacts and lists

Imports, duplicates, subscription state, lists, and data quality.

What is a contact?

Short answer A contact is a customer record that can contain a phone number, name, email, customer ID, subscription state, activity, loyalty, and transaction fields. Available data depends on its source.

What is a customer list?

Short answer A list is a selectable audience definition. A contact may qualify for multiple lists, but should not receive duplicate copies merely because those lists overlap.

If I upload duplicate contacts, does Blackleaf handle them?

Short answer Yes. Imports match a usable phone first; without one they can match email, and a customer ID can also match. A match updates the record instead of intentionally creating another contact.

Inconsistent or missing identifiers can still create separate records. Duplicate cleanup preserves an opt-out when any merged duplicate is opted out.

Imported rowPhone / customer IDEmail fallbackExisting contactupdate, not duplicate
If someone unsubscribes and I upload them again, will it resubscribe them?

Short answer Not when the upload action is “None.” Imports can explicitly set contacts to “Subscribed” or “Unsubscribed,” so never choose “Set as Subscribed” without valid, documented authority to restore consent.

A routine data refresh is not consent. Leave the action as “None” or “Unsubscribed” unless the person completed a valid re-opt-in.

Data refreshdoes not add consentValid re-opt-indocumented consentSubscription state
How is an imported row matched?

Short answer Blackleaf uses a valid cleaned phone when available, otherwise a valid email, and can also match a mapped customer ID. Matching depends on correctly mapped identifiers.

What happens to invalid phone numbers?

Short answer Blackleaf cleans common formatting and marks numbers that fail basic validation as invalid. They cannot receive a text.

Format validation does not prove a number is mobile, active, owned by the intended person, or reachable.

Does importing a phone number prove consent?

Short answer No. A phone number in a CSV, POS, order, or customer record is not by itself proof of SMS consent.

Keep records of how, when, and for which program the person opted in.

What does import action “None” do?

Short answer It imports or updates mapped customer data without intentionally changing subscription state. Use it for ordinary data refreshes.

What do “Set as Subscribed” and “Set as Unsubscribed” do?

Short answer They explicitly change subscription state for imported or matched rows. “Subscribed” requires valid consent; “Unsubscribed” places the contact in the opted-out state.

Why is a list count different from the recipient count?

Short answer Lists can contain opted-out, invalid, duplicated, recently messaged, or otherwise ineligible contacts. The campaign estimate reflects applicable filtering.

Can I export contacts?

Short answer Yes. Contacts supports exports including all, active/subscribed, and unsubscribed records. Treat every export as sensitive customer data.

campaigns

Campaigns

Creating, testing, scheduling, pausing, and interpreting campaigns.

What is a campaign?

Short answer A campaign defines an audience, message, sender, destination, timing, and reporting context for a group of messages.

What does a campaign need before it can run?

Short answer A sendable campaign needs a valid recipient list plus the required sender, content, destination, and scheduling data for its type. The composer identifies missing or invalid fields.

What is a one-time campaign?

Short answer It sends the configured message to the eligible audience once, immediately or at the scheduled time.

What is an automated campaign?

Short answer It sends when configured customer or system events meet its rules, rather than launching one fixed audience once.

How do recent-message exclusions work?

Short answer The composer can exclude contacts messaged today or in the last 48 hours, 72 hours, or 7 days. The selected exclusion is applied while building the audience.

What happens when I pause or stop a campaign?

Short answer Blackleaf stops eligible queued work and changes campaign status. Messages already handed to a carrier, in transit, or delivered cannot be recalled.

After pausing, check status and counts before deciding whether to resume or send a follow-up.

Pause / stopQueued work haltsAlready submittedCannot be recalledFinal receipt may follow
Can I edit a campaign after it starts?

Short answer Some data can remain editable, but changes cannot rewrite messages already submitted to carriers. Pause when appropriate, verify what remains, and test revisions.

What does “Send a test” do?

Short answer It sends the current rendered message to the test recipient and reports server delivery data such as status, sender, recipient, body, image, link, and cost when available. It does not launch the campaign.

What is the content check?

Short answer It validates content against Blackleaf’s current checks. A pass does not guarantee carrier acceptance, delivery, or legal compliance.

Why did my recipient estimate change?

Short answer Counts change when lists, exclusions, subscription state, phone validity, duplicate resolution, or source customer data changes.

What do campaign statuses mean?

Short answer Draft is not launched; scheduled waits for send time; sending is processing; paused halts eligible queued work; completed finished processing; stopped was ended. Individual messages can have different outcomes.

messaging

SMS, MMS, and delivery

Formats, segments, personalization, statuses, and failures.

What is SMS?

Short answer SMS is text-only carrier messaging. Long content and some characters can split one visible text into multiple billable segments.

What is MMS?

Short answer MMS can include an image with text. Device, carrier, destination, media, and sender support can affect delivery.

How are SMS segments counted?

Short answer GSM-7 SMS fits up to 160 characters in one segment and generally 153 per joined segment. UCS-2 content fits 70 in one and generally 67 per joined segment.

The composer shows the current estimate. Sender type and carrier behavior can create exceptions.

GSM-7160 / 153Unicode / emoji70 / 67segments × audience
Why did emoji or special punctuation increase the count?

Short answer One non-GSM character can change the entire SMS to UCS-2, which has less capacity. Emoji, smart quotes, long dashes, and accented characters are common causes.

Do variables affect message length?

Short answer Yes. Substituted values can produce a different final length and segment count for each recipient. Leave room for realistic values and test.

Which text variables are available?

Short answer The composer can insert first name, last name, points, lifetime points, loyalty level, date of birth, weekday, and day of month. A value requires usable contact data.

Why do my messages fail?

Short answer Common causes include an invalid or unreachable number, unsupported destination, opt-out, missing registration, carrier filtering, blocked content or links, sender setup, media failure, balance, or network/provider error.

Check the message result for the status or error and look for a broader incident on System Status. If you contact Support, include the affected store, approximate time and time zone, and message ID if available. Leave customer phone numbers and message contents out of the public form.

Does Delivered mean the person read it?

Short answer No. Delivered means the downstream network reported delivery. SMS/MMS generally does not provide a reliable read receipt.

What do sent, in transit, delivered, failed, and undelivered mean?

Short answer Sent was accepted for downstream processing; in transit awaits a final result; delivered received a positive receipt; failed or undelivered did not complete delivery. Exact detail comes from the returned status.

Can Blackleaf guarantee delivery?

Short answer No. Blackleaf validates and submits eligible messages, but carriers and devices make downstream decisions. Good consent, registration, content, and data improve outcomes without guaranteeing them.

Can links be clickable and tracked?

Short answer Yes. Supported links can be shortened or tracked and report clicks. A click is link activity, not proof of a purchase.

10dlc

10DLC and sender registration

Registered identity and use cases for U.S. business texting.

Why do I need 10DLC?

Short answer Carriers require U.S. business traffic over local 10-digit numbers to have a registered sender and use case. Registration makes the sender and purpose traceable.

Registration is not consent and does not guarantee delivery.

What is a 10DLC brand?

Short answer The brand is the verified legal entity responsible for the program. Submitted identity data must match authoritative business records.

What is a 10DLC campaign registration?

Short answer It is the registered use case associated with a brand, including message purpose, opt-in/out flow, samples, and program details.

How long does 10DLC registration take?

Short answer Timing varies with verification, review, and corrections. Use the status in Blackleaf or ask Support for the current account-specific state.

age-gates

Identity gates and regulated content

Why Blackleaf confirms the intended recipient before showing regulated campaign content.

Why do I have to use an age gate?

Short answer For regulated campaigns, Blackleaf uses the gate to confirm that the visitor is the person the message was intended for before revealing the campaign destination.

The sender is expected to know that the recipient is eligible before sending. The gate supports the regulated carrier workflow by matching the visitor to information already associated with the intended recipient; it is not a new age determination and does not replace consent, sender registration, or legal review.

Does an age gate prove legal age?

Short answer No. Blackleaf’s gate is an identity check, not an age determination. It asks the visitor to recognize the birthday associated with the intended recipient record before opening the message.

Why does the identity gate ask for a birthday?

Short answer Birthday is a practical detail the intended recipient previously supplied and can recognize, so it can help match the visitor to the customer record without asking them to enter additional information.

The business must establish eligibility before sending. Recognizing a birthday at the gate does not create consent, prove ownership of a phone, or replace any required eligibility process.

Is passing an age gate the same as opting in?

Short answer No. Identity confirmation and SMS consent are separate. Passing the gate does not subscribe someone to messages.

Which domain does the age gate use?

Short answer The campaign uses the age-gate link domain selected in the landing-page toolbar. Available domains depend on account configuration.

Can I bypass the age gate?

Short answer Do not bypass the approved identity-gated workflow for content that requires it. If you believe a campaign does not need the gate, ask Support before sending.

landing-pages

Landing pages and links

Hosted content, redirects, calls to action, and tracking.

What is the difference between Landing Page and Redirect?

Short answer Landing Page shows the campaign’s hosted image and/or HTML after the age gate. Redirect sends the visitor to the configured destination URL after the gate.

For API integrations, read the MMS API guide for the image and landingImage field map, media review and linked-page setup.

What can a landing page contain?

Short answer It can contain a landing image, custom HTML, and a call-to-action button with a label and URL. Keep content mobile-friendly and compliant.

Can a landing page use only an image?

Short answer Yes. A landing image can be used without custom HTML. Add a button when the visitor needs a clear next action.

What is the landing-page button URL?

Short answer It is the destination opened by the call-to-action button. Test the full URL on a phone and make the label accurately describe the action.

How are landing views and clicks counted?

Short answer A view is recorded when tracked content loads; a click is recorded for supported tracked actions. Repeat visits, privacy tools, blocked scripts, and sharing can affect counts.

Does previewing a landing page save or publish it?

Short answer No. Preview shows current content, including draft content where supported. The campaign still needs the normal save and launch actions.

automations

Automations

Event-driven messages, delays, eligibility, and testing.

What is a messaging automation?

Short answer An automation sends when a qualifying event or customer condition occurs. Examples include lifecycle, loyalty, birthday, order, win-back, and review workflows.

Can an automation send to an opted-out contact?

Short answer It should not. Opt-out and eligibility checks still apply. An operational trigger is not permission to send marketing content.

What is an automation wait time?

Short answer It is the delay between a qualifying event and the attempted send. Consider data arrival, timing, time zones, and quiet hours.

How should I test an automation?

Short answer Use a controlled contact and event. Verify trigger, delay, variables, sender, links, opt-out behavior, and delivery before broad activation.

Why did an automation not send?

Short answer The event may not match, a delay may be active, the contact may be ineligible, data may be missing, the automation may be disabled, or validation/delivery may have failed.

inbox

Inbox and two-way messaging

Customer replies, team conversations, and opt-outs.

What is the Blackleaf Inbox?

Short answer The Inbox is the shared workspace for inbound and outbound customer conversations on connected messaging numbers.

Do campaign replies appear in the Inbox?

Short answer Replies to supported connected numbers can appear in the shared Inbox so authorized team members can respond.

Can I manually reply after a customer says STOP?

Short answer Do not send marketing or conversational replies that bypass an opt-out. Use the system handling and escalate a genuinely necessary support response when unclear.

ai-images

AI Images

Projects, brands, references, outputs, and human review.

What is an AI Image project?

Short answer It groups generation history, settings, selected brand, references, and outputs for a creative workflow.

Can one AI Image project be used by multiple campaigns?

Short answer Yes. Reusing a project also reuses its context, so verify its selected brand and references before generating.

What does Brand control?

Short answer Brand selects the identity and saved assets the project should use. Confirm it when an account serves multiple locations or brands.

What image types can AI Images create?

Short answer The workflow can create assets such as MMS, sales-flyer or landing images, and supported social formats. Options depend on current configuration.

How do I use a generated image in a campaign?

Short answer Use the add/use control. An MMS result can become the campaign MMS image; a landing or sales-flyer result can become the landing image.

Does an AI image guarantee accurate or compliant content?

Short answer No. Review spelling, dates, prices, products, logos, rights, regulated content, disclaimers, and mobile rendering before use.

Automated validation can catch some issues but does not replace human approval.

integrations

Integrations and API

POS data, synchronization, matching, and API access.

Do I need to switch POS systems to use Blackleaf Texting?

Short answer No. You can keep your existing POS when it has a supported connection for your Texting workflow. Confirm which customer, order or loyalty data your setup can share and how often it updates.

What can an integration sync?

Short answer Depending on the connector, Blackleaf can receive customer, transaction, loyalty, order, product, and event data. Fields and timing vary by integration.

Is POS data synchronized in real time?

Short answer Not always. Timing depends on the connector, source, data type, and processing state. Use the integration’s documented cadence for time-sensitive rules.

Can an integration create duplicate contacts?

Short answer Blackleaf matches available identifiers, but missing, changed, shared, or inconsistent identifiers can produce separate records. Names alone are not unique.

billing

Billing and cost

Subscriptions, usage, estimates, segments, and current pricing.

What is subscription versus usage?

Short answer The subscription covers plan access. SMS/MMS usage is based on messages or segments under published plan rates; other current fees appear on Pricing.

Why do estimated and actual costs differ?

Short answer Estimate uses the current audience, type, segments, and rate. Actual cost reflects final recipients, rendered segments, message type, and processing.

Am I charged for a failed message?

Short answer It depends on when and why it failed and what downstream processing occurred. Use actual campaign cost and billing records; ask Support if unclear.

reporting

Reporting and attribution

Counts, receipts, clicks, views, transactions, and limits.

Which campaign metrics are available?

Short answer Campaign details can show recipients, cost, sent, in transit, delivered, failed, clicks, and views. Performance can include transactions, revenue, purchasing recipients, and opt-outs when data is available.

Why do status counts change after sending?

Short answer Delivery receipts arrive asynchronously. Messages can move from sent or in transit to delivered, failed, or undelivered later.

Why do delivery counts not add up yet?

Short answer Some messages may remain queued/in transit or await receipts. Recheck after processing and inspect remaining pending items.

What counts as a click?

Short answer A click is a request through a supported tracked link. It is not necessarily a unique person, store visit, or purchase.

What counts as a view?

Short answer A view is a tracked load of supported content. Privacy controls, repeats, sharing, and blocked tracking can affect it.

How is revenue attributed?

Short answer Eligible transaction data is associated with campaign recipients under configured reporting logic. It is an analytical association, not proof the message alone caused a purchase.

Why is purchase or revenue data missing?

Short answer POS/customer data may be delayed, unmatched, unavailable, or outside reporting logic. Confirm integration health and identifiers before treating blank as zero.

security

Privacy and security

Safe account use, exports, credentials, and incidents.

What customer data should I upload?

Short answer Only data your organization is authorized to use and Blackleaf needs for the workflow. Avoid unnecessary sensitive information.

How should I handle exports?

Short answer Treat them as sensitive customer data. Use approved storage, limit access, transmit securely, and delete local copies under your retention policy.

Can I share my password or API key with Support?

Short answer No. Never send passwords, full API keys, session tokens, or payment details in support or chat. Support does not need your password.

troubleshooting

Troubleshooting

Fast checks for common audience, sending, image, link, and reporting problems.

Why does my campaign show zero recipients?

Short answer No list may be selected, or all contacts may be invalid, opted out, duplicated, recently messaged, or excluded. Review audience and exclusion counts.

Why did the content check fail?

Short answer The body, link, image, destination, or regulated content may violate a current check or be incomplete. Use the returned reason, correct it, and validate again.

Why did my test not arrive?

Short answer Confirm the test number, sender, content, image, balance, and returned test status. The device may be unreachable or the carrier may filter or delay it.

If the result is unclear, follow the SMS delivery troubleshooting guide before trying again. If you contact Support, include the affected store, approximate time and time zone, and any status or message ID available.

Why is my MMS image missing?

Short answer Open the affected message record. Check whether it includes the image, then read the latest delivery status and any provider error.

If you supplied a hosted image, confirm the exact file is still available and meets the sending route’s requirements before retrying.

Why does my landing page look wrong on a phone?

Short answer Custom HTML, fixed widths, large assets, external styles, or browser differences can change rendering. Use responsive content and test the actual age-gate link.

What should I give Support?

Short answer Include the affected store, the step that failed, the approximate time and time zone, and any status or error. For a Texting delivery issue, add the message, campaign, or API request ID if available. Keep customer phone numbers, message contents, and API keys private.