NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Goodbits connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Goodbits actions, such as "Create Link", "Create Subscriber" and "Get Newsletter Info". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Goodbits, with input parameters and output schema.
GOODBITS_CREATE_LINKTool to create a content link in Goodbits Content Library. Use when you have an article URL and optional metadata ready.
Input parameters
The URL of the article to save
Optional custom title for the link
Optional HTML description of the article
Optional list of candidate thumbnail image URLs
Optional image URL to fetch as thumbnail
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOODBITS_CREATE_SUBSCRIBERTool to add a new subscriber to the newsletter. Use after confirming user opt-in.
Input parameters
Subscriber object containing email and optional name details
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOODBITS_DELETE_SUBSCRIBERTool to mark a subscriber as deleted. Use when you need to prevent future emails being sent to a subscriber.
Input parameters
Subscriber's email address to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOODBITS_GET_NEWSLETTERTool to fetch newsletter identifier and name. Use after authenticating with your API token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOODBITS_UPDATE_SUBSCRIBER_STATUSTool to update subscriber status. Use when you need to change an existing subscriber’s subscription status by email. Example: "Update the status of john@example.com to unsubscribed"
Input parameters
Email of the subscriber to update
New status for the subscriber
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 5 Goodbits actions on Nagent, including "Create Link", "Create Subscriber" and "Get Newsletter Info". Create Link: Create a content link in Goodbits Content Library. Each action is listed on this page with its input parameters and its output.
Goodbits connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Link takes 1 required input: url. It also takes 4 optional inputs: title, description, image_candidates and fetch_remote_thumbnail_url. It returns data, error and successful.