Generate Ice Breakers

GET /generate-icebreakers
Description

This endpoint generates personalized ice breakers to help initiate conversations with a lead, based on their enriched persona derived from their LinkedIn profile. It leverages Behavely AI's insights and OpenAI-generated content to craft relevant, engaging, and context-aware conversation starters that align with the lead's interests and behavior.

Query Parameters

Parameter

Type

Required

Description

linkedin_url

string

✅ Yes

The full LinkedIn profile URL of the lead.

api_key

string

✅ Yes

The user’s unique API key for authentication.

product_name

string

✅ Yes

A short description of the product or service you are selling.

enable_find_social_media

boolean

❌ No

If true, triggers additional social media analysis for more accurate insights (default: false).

Authentication

Requires a valid API key, passed as a query parameter. The API uses this key to validate the user and check crawl limits.

How It Works

  1. User Authentication
    The API verifies the user via the provided API key using a DynamoDB api_key-index.

  2. Input Validation
    It checks for the presence of required query parameters: linkedin_url, product_name, and api_key.

  3. Persona Data Retrieval

    • First, it tries to retrieve the cached persona from DynamoDB.

    • If not found and enable_find_social_media is true, it performs social media enrichment using Behavely AI.

  4. Ice Breaker Generation
    Using the persona data, the API generates personalized ice breakers via OpenAI.

Response

✅ Success (HTTP 200)

Returns a list of generated ice breakers tailored to the lead’s persona.

{
  "ice_breakers": [
    "Hi John, I noticed you're deeply involved in fintech innovation—curious what trends you're most excited about lately?",
    "Your recent article on digital payments was insightful! How do you see AI shaping the future of your industry?",
    "I saw you’re interested in growth marketing—would love to hear your take on how emerging tools are influencing customer acquisition."
  ]

❌ Error Responses

HTTP StatusMessageDescription400Missing linkedin_url or api_tokenRequired query parameters not provided.400Missing Api Token. Please create one...No matching API key found in the user table.404User not foundUser with provided API key could not be located.500Failed to fetch persona from external APIPersona data could not be retrieved or generated.

Sample GET Request