Tips and tricks
Copy a card template from one environment to another
Copy a card template manually
- In the
Cardsview, select the overflow menu (3 vertical dots) of the card you wish to move.
Copy to clipboard, which copies the card JSON definition to clipboard.
- In the new/destination environment, select
- In the left hand editor, down the bottom next to
- Delete the contents of
Raw card dataand paste in the card JSON definition.
- If your card template references an image or video that was uploaded to the Media area, you will need to re-upload that media in your new environment. If your card template references externally hosted media assets then they will continue to work.
- You will need to re-publish the copied cards, since they will be created in a draft state.
Customise the messages shown in a stream container
Stream containers can be configured with different display modes, styling, behaviour as well as the following strings:
- The title to display at the top of the card list. If not specified, defaults to "Cards".
- The message displayed when the user has received at least one card before, and there are no cards to show - defaults to "All caught up".
- The message displayed over the card list, when the user has never received a card before - defaults to "Cards will appear here when there’s something to action."
- The title for the feature allowing a user to snooze a card - defaults to "Remind me".
- The title to display for the action a user taps when they flag a card as useful - defaults to "This is useful".
- The title to display for the action a user taps when they flag a card as not useful - defaults to "This isn't useful".
- The title to display at the top of the screen allowing a user to provide feedback on why they didn't find a card useful - defaults to "Send feedback".
This list is not complete, please refer to the SDK guides for a complete overview.
Read more about customising strings in the stream container in iOS SDK, Android SDK and Web SDK.
Sending requests to the Atomic public API
Using a third-party API client
We recommend using Insomnia and have written step-by-step instructions detailing how to install it and set up your Insomnia environments. If you prefer, you can use other clients such as Postman. All of the required parameters for any of those clients, can be found in the Insomnia instructions.
It is also possible to use the
curl command line tool. Instructions on how to create a token to authenticate your requests can be found under Authentication. Sample curl requests can be found in the Action Flow API section and Cards API section.
Sending cards in languages other than English
It is possible to add card content in different languages; the workbench supports all UTF-8 encoded characters, as do all of the SDKs. You can author different cards for every language you require, or you can have 1 card that uses a variable with multiple text strings in different languages.
The example below shows how a variable
content_message can contain the same message in different languages. The recipient will receive their card based on the value of the
language_code (that can be passed through in the payload for each customer).
It is also possible to customize text strings in the SDKs, to make titles and dialogue messages appear in another language. See Customise the messages shown in a stream container for some examples and links to the relevant sections in the SDK guides.