Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | ID marki z ocoya_list_brands. |
prompt | string | Yes | Prompt lub brief kampanii. Opisz tutaj odbiorców i ton — jedno dobrze zbudowane zdanie powie więcej niż sztywna lista. |
goal | string | No | Jedno z awareness, leads, launch, offer, education, event. Domyślnie awareness. |
duration | number | No | Czas trwania kampanii w dniach, od 1 do 30. Domyślnie 7. |
startDate | string | No | Dzień pierwszego posta, YYYY-MM-DD. Musi być co najmniej jutro. Domyślnie jutro. |
postsPerDay | number | No | Jak często publikować: 0.5 (co drugi dzień), 1, 2, 3 lub 4. Pomiń, aby rozłożyć posty count równomiernie na duration. |
count | number | No | Liczba postów do wygenerowania, od 1 do 30. Domyślnie 7. |
postLength | string | No | Jedno z short, medium, long, extra_long. Domyślnie medium. |
hashtagLibraryId | string | No | ID biblioteki hashtagów z ocoya_list_hashtag_libraries. |
socialProfileIds | string[] | No | ID podłączonych profili społecznościowych do podpięcia przy zapisywaniu wygenerowanych postów kampanii. |
generateMedia | boolean | No | Czy generować grafiki do postów kampanii. |
imageCount | number | No | Liczba obrazów do wygenerowania dla każdego posta w kampanii, od 1 do 10. Wartości powyżej 1 tworzą kreatywy w stylu karuzeli. Domyślnie 1. |
referenceUrls | string[] | No | URL-e obrazów do użycia jako referencje wizualne, gdy generateMedia jest true. Maksymalnie 3. |
referenceDesignIds | string[] | No | ID projektów Studio z ocoya_list_studio_templates do użycia jako referencje wizualne, gdy generateMedia jest true. Maksymalnie 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
Zwraca ID zakolejkowanej kampanii, status GENERATING oraz metadane postępu generowania.
To narzędzie nie czeka na wygenerowanie postów. Generowanie kampanii działa w tle, więc klient powinien traktować natychmiastową odpowiedź jako zakolejkowane zadanie i sprawdzić kampanię później w Ocoya.