Symptom: Error: “Invalid JWT Token” when accessing Act! Marketing Automation
Product Details:
- Product Family: Emarketing
- Product: Act! Marketing Automation
Solution:
If you receive an error regarding “Invalid JWT Token” when accessing your Marketing Automation service, this indicates that either your Act! API or your Act! database is not configured correctly. Please follow the guidance below to ensure you are setup to allow the Marketing Automation feature to function correctly.
For Act! Marketing Automation to function correctly, there are a couple of prerequisites which are detailed below. Please follow the guidance provided in each of these sections to ensure you are setup to use Marketing Automation successfully. Ensure your installation of Act! is correctly registered as per the below article: Please Note: We strongly recommend you update your Act! software to V21 Update 5 as a minimum due to some known issues that were resolved in this version of the software. Updates for Act! are available to download here. For more information on ensuring your Act! API has been correctly set up, please see the following article: How do I set up the Act! API? If you have registered Act! with a subscription serial number that is entitled to Marketing Automation and configured your API correctly, but you are still experiencing the same error, you may have an issue with the database itself being misconfigured. Marketing Automation uses your secure API URL to allow communication between the Act! software, your Act! database and the Marketing Automation servers hosted by Swiftpage. This API URL needs to be applied to any database intending to use Marketing Automation. Depending on your Act! deployment, this preference is named ‘UPWARD_API_STREAMER’ (Act! /Access Via Web) or ‘APCAPIURL’ (Act! in the Cloud). This database preference is not exposed directly via the Act! software so it is necessary to use one of the batch files attached to this article on your database to both view and correct your API URL if we believe it may be incorrect. ‘Act! Desktop software and Act! access via Web users’ ‘Act! in the Cloud users’ The preference for Act! in the Cloud databases is applied and managed by Swiftpage. If you are receiving this error when logging in to an Act! in the Cloud database via a web browser, please contact our support team who will be happy to assist. https://www.act.com/contact-us If you are seeing this error in a remote database that synchronises with an Act! in the Cloud database, but you are not seeing the same error when logging in to your Act! in the Cloud database via a web browser, you can follow the instructions below to resolve the issue: What is my Act! in the Cloud API URL? The Act! in the Cloud API URL takes the format of your Cloud URL suffixed with "-api/act.web.api". For Example: Cloud Login URL: https://usp1-iis-99.hosted1.act.com/YourSiteName/ API URL: https://usp1-iis-99.hosted1.act.com/YourSiteName-api/act.web.api Please note: The following guidance is for experienced IT technicians or Act! certified consultants only and is not intended for general use. We have a plugin available that exposes some configuration information for your Act! application and Act! database that may help in identifying issues with your Marketing Automation service. The plugin AmaDebug.dll can be downloaded from the link provided at the bottom of this article. Follow the instructions below to install and use this plugin. The AMA Debug window displays a small selection of configuration values that are pulled from both your local Act! application and the database you are connected to. Below is an explanation of some of these values. Configuration The 3 rows in this section are presented in order of importance. It is possible that all 3 rows could have a valid API URL, but the topmost value will be the one that is used by Act! when using the Marketing Automation service. UPWARD_API_STREAMER (Config) – This value is taken from the local Act!.exe.config located at C:\Program Files (x86)\ACT\Act for Windows\Act!.exe.config. By default, there will be no key for UPWARD_API_STREAMER in this config file, but you can add this key yourself if you wish to manually override the UPWARD_API_STREAMER preference found in the database for testing purposes. Note: This will override the Marketing Automation API URL for all databases accessed via that installation of Act! until the value is removed again from the Act!.exe.config file. Example UPWARD_API_STREAMER config value for the Act!.exe.config file: <add key="UPWARD_API_STREAMER" value="https://testingAPI.com/act.web.api/" /> APCAPIURL – This database preference is present in TBL_PREFERENCE. It is used to define the Marketing Automation API URL for our Act! Cloud customers. You will find this value present in remote databases that have been created from an Act! Cloud database. This preference will also override any value found in the database preference UPWARD_API_STREAMER that is detailed below. UPWARD_API_STREAMER – This value is automatically created within an Act! database either by logging in using the desktop software or via a browser for Act! access via Web customers. If there are no values found in UPWARD_API_STREAMER (Config) or APCAPIURL, then this API URL will be used by Act! when accessing the Marketing Automation feature in this database. Information Target – This denotes the regional Marketing Automation server that your Act! installation will attempt to communicate with when opening this feature. More information regarding this can be found here: How to change the regional server used for Act! Marketing Automation Language – This is the language detected by your Act! installation API – A confirmation of the API URL that Act! will be using when opening Marketing Automation for the database you are currently logged in to Serial – The activation key being used by your Act! installation Host – The computer name of the server your database is hosted on Database – The name of the database you are currently logged in to Username – The username of the Act! user you are currently logged in as I’m using Marketing Automation for the first time
How to Register or Activate Act! from v21.1 Onwards
I’ve registered Act! and configured my API, but I’m still seeing the same error
This setting should be automatically applied by Act! when the API is configured correctly, but in some cases this might fail and we need to take manual action to correct it.
Follow the instructions below for your Act! deployment type to verify the API URL that your database is currently using and to correct it where necessary. These steps need to be carried out on the server hosting your database and you need to be aware of your API URL before proceeding.
Further troubleshooting with the AMA Debug Plugin