Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | ID del brand da ocoya_list_brands. |
prompt | string | Yes | Prompt o brief della campagna. Descrivi qui il pubblico e il tono — una frase dice più di quanto potrebbe fare un elenco fisso. |
goal | string | No | Uno tra awareness, leads, launch, offer, education, event. Predefinito: awareness. |
duration | number | No | Durata della campagna in giorni, da 1 a 30. Predefinito: 7. |
startDate | string | No | Giorno del primo post, formato YYYY-MM-DD. Deve essere domani o una data successiva. Predefinito: domani. |
postsPerDay | number | No | Frequenza di pubblicazione: 0.5 (a giorni alterni), 1, 2, 3 o 4. Se omesso, distribuisce i post di count in modo uniforme su duration. |
count | number | No | Numero di post da generare, da 1 a 30. Predefinito: 7. |
postLength | string | No | Uno tra short, medium, long, extra_long. Predefinito: medium. |
hashtagLibraryId | string | No | ID della libreria di hashtag da ocoya_list_hashtag_libraries. |
socialProfileIds | string[] | No | ID dei profili social connessi da collegare quando i post della campagna generata vengono salvati. |
generateMedia | boolean | No | Se generare o meno immagini per i post della campagna. |
imageCount | number | No | Numero di immagini da generare per ogni post della campagna, da 1 a 10. Valori superiori a 1 creano creatività in stile carosello. Predefinito: 1. |
referenceUrls | string[] | No | URL di immagini da usare come riferimenti visivi quando generateMedia è true. Massimo 3. |
referenceDesignIds | string[] | No | ID dei design Studio da ocoya_list_studio_templates da usare come riferimenti visivi quando generateMedia è true. Massimo 3. |
Request example
{
"name": "ocoya_create_ai_campaign",
"arguments": {
"brandId": "cmayvq3hk00017apshay5qezu",
"prompt": "Summer launch campaign for our ecommerce analytics dashboard, aimed at marketing teams already using spreadsheets. Confident, practical tone.",
"goal": "launch",
"duration": 10,
"count": 6,
"postLength": "medium",
"hashtagLibraryId": "cmayw7l5200067apsmz2tv7e8",
"socialProfileIds": ["clh49poxf008x8kov4ncbjty9"],
"generateMedia": true,
"imageCount": 3
}
}Returns
Restituisce l’ID della campagna messa in coda, lo stato GENERATING e i metadati di avanzamento della generazione.
Questo tool non aspetta che i post vengano generati. La generazione della campagna viene eseguita in background, quindi i client dovrebbero considerare la risposta immediata come un job messo in coda e controllare la campagna in un secondo momento in Ocoya.