Skip to main content

Troubleshooting Your Postscript Integration

Learn how to resolve common issues with SMS delivery, opt-in messages, and discount code visibility within Postscript.

Written by Rojen M Reji
Updated this week

Initial Opt-in Message Location

A common point of confusion for new users is where the initial "Welcome" text message is configured. If you are using Onsite Opt-in, the first text message sent to your customers is managed directly within the Alia editor rather than the Postscript dashboard.

Because Alia handles the initial collection and verification for Onsite Opt-in, you must customize the message content using the following steps:

  1. Navigate to your pop-up editor in the Alia dashboard.

  2. Select the submit button on the SMS tab of the pop-up.

  3. On the right-hand side, under PostScript integration settings, you will see the message box where you can customize the first welcome message to reflect your brand's voice and include necessary compliance language.

πŸ’‘ Subsequent automation flows and campaign blasts will still be managed entirely within your Postscript dashboard.


SMS Delivery and Subscription Issues

If you notice that texts are not being sent or users are not appearing as "Subscribed" in Postscript after interacting with your Alia popup, the most frequent cause is account verification.

Postscript requires all accounts to go through a verification process before they are permitted to send live SMS marketing messages. If your number is not yet verified by Postscript:

  • Check your Postscript dashboard for any "Action Required" banners regarding carrier registration or brand verification.

  • Ensure you have completed the TCPA compliance requirements within Postscript.

  • Verify that your Postscript API key is correctly pasted into the Alia integration settings.

Until Postscript completes this verification, messages will remain in a pending state, and users will not be officially opted-in to your marketing lists.


Resolving Discount Code (alia_offer) Issues

If the alia_offer property is appearing as blank or failing to show up in your Postscript texts, it usually stems from how the data is being passed from the popup to the integration. This often happens when the code is only being passed on the "Confirmation" screen rather than the "Submit" action.

How to fix missing discount properties:

To ensure the discount code is successfully sent to Postscript, you must attach it as a property to the specific buttons that trigger the data sync:

  1. In the Alia editor, select your Email Submit and SMS Submit buttons.

  2. Ensure that the alia_offer property is included in the attributes being passed upon the button click.
    ​
    ​


    ​

  3. Set a Backup Code within your Postscript property settings. This ensures that if for any reason the dynamic code fails to generate, the user still receives a valid generic discount.

πŸ’‘ Always test your integration in "Preview" mode to ensure that the alia_offer variable is populating correctly in your test subscriber profile before going live.

Did this answer your question?