Skip to main content

Automated Marketing Content Generation

Scenario: Automatically create product descriptions from spreadsheet data.

How Tess API Helps: Tess can generate engaging product descriptions based on product details stored in a spreadsheet, saving marketers time and ensuring consistency across your catalog.

Workflow​

  1. Trigger: A new row is added to a spreadsheet (e.g., Google Sheets).
  2. Action: Send the product details (name, features, etc.) to Tess using the /agents/{id}/execute endpoint with a content generation agent. Set wait_execution=true for immediate results.
  3. Action: Update the spreadsheet with the generated description.

Example Tess API Request​

1. Send Product Details to Tess Agent​

POST /agents/{agent_id}/execute?wait_execution=true
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "temperature": "1",
  "model": "tess-5",
  "messages": [
    { "role": "user", "content": "Generate a product description for: Wireless Headphones. Features: Bluetooth 5.0, Noise Cancelling, 20h Battery Life." }
  ],
  "tools": "no-tools",
  "wait_execution": true
}

Response Example:

{
  "template_id": "8794",
  "responses": [
    {
      "id": 4773337,
      "status": "succeeded",
      "input": "Generate a product description for: Wireless Headphones. Features: Bluetooth 5.0, Noise Cancelling, 20h Battery Life.",
      "output": "Experience true freedom with our Wireless Headphones featuring Bluetooth 5.0, advanced noise cancelling, and up to 20 hours of battery life. Perfect for music lovers on the go!",
      "credits": 0.000337,
      "root_id": 4773337,
      "created_at": "2025-01-05T19:35:21.000000Z",
      "updated_at": "2025-01-05T19:35:23.000000Z",
      "template_id": 8794
    }
  ]
}

2. Update the Spreadsheet​

Use your spreadsheet provider's API (e.g., Google Sheets API) to write the generated description back to the appropriate row.

Benefits​

  • Saves time on content creation
  • Ensures consistent tone and style
  • Ideal for marketing teams managing large catalogs

Endpoints Used​

  • POST /agents/{id}/execute

Tip: Use automation tools like Zapier or Make to connect your spreadsheet and Tess API for a seamless workflow!