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.
  • When moving cards using the API (see below) the card’s published state is maintained. However, when manually copying the JSON, you will need to re-publish cards.

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".
Learn more

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.

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.