Skip to main content

Tips and tricks

Copy a card template from one environment to another​

Copy a card template manually​

  1. In the Cards view, select the overflow menu (3 vertical dots) of the card you wish to move.
  2. Select Copy to clipboard, which copies the card JSON definition to clipboard.

copy_card.png

  1. In the new/destination environment, select New Card.
  2. In the left hand editor, down the bottom next to Advanced, select Show
  3. Delete the contents of Raw card data and paste in the card JSON definition.

advanced_show.png

Notes
  • 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.

Customize the messages shown in a stream container​

Stream containers can be configured with different display modes, styling, behavior 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.

Learn more

Read more about customizing 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.

Using curl​

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 Customize the messages shown in a stream container for some examples and links to the relevant sections in the SDK guides.

Last updated on