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 |
---|---|---|---|
| string | ✅ Yes | The full LinkedIn profile URL of the lead. |
| string | ✅ Yes | The user’s unique API key for authentication. |
| string | ✅ Yes | A short description of the product or service you are selling. |
| 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
User Authentication
The API verifies the user via the provided API key using a DynamoDBapi_key-index
.Input Validation
It checks for the presence of required query parameters:linkedin_url
,product_name
, andapi_key
.Persona Data Retrieval
First, it tries to retrieve the cached persona from DynamoDB.
If not found and
enable_find_social_media
istrue
, it performs social media enrichment using Behavely AI.
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.
❌ Error Responses
HTTP StatusMessageDescription400Missing linkedin_url or api_token
Required query parameters not provided.400Missing Api Token. Please create one...
No matching API key found in the user table.404User not found
User with provided API key could not be located.500Failed to fetch persona from external API
Persona data could not be retrieved or generated.