> ## Documentation Index > Fetch the complete documentation index at: https://invoca-5bd45748-mintlify-8d5425ca.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Whisper Prompts > Configure the whisper messages Invoca plays to the receiving agent before a caller is connected on an advertiser campaign, via the Network Integration API. ## Manage Whisper Prompts for Campaigns A whisper prompt can be created from provided text or a professional prompt recording can be assigned as a whisper prompt. ### Create Whisper Prompt **Example: create whisper prompt** POST `https://invoca.net/api/@@NETWORK_API_VERSION//advertisers//advertiser_campaigns/.json` Request Body ```json theme={null} { "ivr_tree": { "record_calls": false, "whisper_prompt_text": "How are you today?", "root": { "node_type": "Connect", "destination_phone_number": "8056173768", "destination_country_code": "" } } } ``` ### Assign Prompt Recording as Whisper Prompt **Example: assign prompt recording as whisper prompt** POST `https://invoca.net/api/@@NETWORK_API_VERSION//advertisers//advertiser_campaigns/.json` Request Body ```json theme={null} { "ivr_tree": { "record_calls": false, "whisper_prompt_id_from_network": "rec34", "root": { "node_type": "Connect", "destination_phone_number": "8056173768", "destination_country_code": "" } } } ``` ### Retrieve Whisper Prompt for a Campaign **Example: retrieve whisper prompt for a campaign** GET `https://invoca.net/api/@@NETWORK_API_VERSION//advertisers//advertiser_campaigns/.json` Response (complete response not shown) ```json theme={null} { "name": "Selling Shoes", "status": "Activated", "future_terms": { "ivr_tree": { "record_calls": false, "whisper_prompt_text": "How are you today?", "whisper_prompt_id_from_network": "rec34", "root": { "node_type": "Connect", "destination_phone_number": "8056173768", "destination_country_code": "" } } } } ``` ### Set Whisper Prompt Condition A whisper prompt condition can be set for a campaign to determine whether or not to play the whisper prompt in a call. The prompt will only be played if the full condition is met. To conditionally play whisper prompts during calls, set a whisper prompt using `"whisper_prompt_text"` or `"whisper_prompt_id_from_network"` field and set `"whisper_prompt_condition"` to the expression you want to evaluate. POST `https://invoca.net/api/@@CAMPAIGN_FEATURES_API_VERSION//advertisers//advertiser_campaigns/.json` Example Request Body ```json theme={null} { "ivr_tree": { "record_calls": false, "whisper_prompt_text": "You have reached our business during hours. Please wait while we connect you." "whisper_prompt_condition": "during_hours and repeat", "root": { "node_type": "Connect", "destination_phone_number": "8056173768", "destination_country_code": "" } } } ``` ### Remove Whisper Prompt Condition To remove whisper prompt condition set `"whisper_prompt_condition"` to empty string `""`. POST `https://invoca.net/api/@@CAMPAIGN_FEATURES_API_VERSION//advertisers//advertiser_campaigns/.json` Example Request Body ```json theme={null} { "ivr_tree": { "record_calls": false, "whisper_prompt_text": "Welcome to Invoca. Please wait while we connect you." "whisper_prompt_condition": "", "root": { "node_type": "Connect", "destination_phone_number": "8056173768", "destination_country_code": "" } } } ``` ## Conditions | Condition | Details | Examples | | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | during\_hours | True if the caller is calling during the hours specified in the campaign. | during\_hours | | repeat | True if the caller has already called this campaign in the last N days (the interval N can be set on the campaign; the default is 30 days). | repeat | | landline | True if the caller is calling from a landline phone. | landline | | mobile | True if the caller is calling from a mobile phone. | mobile | | pressed\[key] | True if the caller pressed the key. Supported characters (case sensitive): \[1-9, a-z, W, N]. For a sub-menu keypress, join characters in their expected order with spaces (e.g. 1 1 2). | pressed\[3] | | custom\_data\[field\_partner\_name] | True if the custom data field value matches (=) the expected value. True if the custom data field value does not match (!=) the expected value. True if the custom data field value contains (contains) the expected value. True if the custom data field value is present (present). | custom\_data\[product] = "Printer", custom\_data\[product] != "Fax Machine", custom\_data\[product] contains "Chair", custom\_data\[product] present | | affiliate\_name | True if the affiliate name value matches (=) the expected value. True if the affiliate name value does not match (!=) the expected value. True if the affiliate name value contains (contains) the expected value. True if the affiliate name value is present (present). | affiliate\_name = "Captain Crunch Publishing", affiliate\_name != "Count Chocula Publishing", affiliate\_name contains "Cocoa", affiliate\_name present | | media\_type | True if the media type for the promo number called matches (=) the expected value. True if the media type for the promo number called does not match (!=) the expected value. True if the media type for the promo number called contains (contains) the expected value. True if the media type for the promo number called is present (present). | media\_type = "Online: Content / Review Site", media\_type != "Online: Email", media\_type contains "Online", media\_type present | | promo\_number\_description | True if the description for the promo number called matches (=) the expected value. True if the description for the promo number called does not match (!=) the expected value. True if the description for the promo number called contains (contains) the expected value. True if the description for the promo number called is present (present). | promo\_number\_description = "Very important number", promo\_number\_description != "Old marketing number", promo\_number\_description contains "New ad campaign", promo\_number\_description present | | and | Joins two conditions and is true if both conditions are true. | repeat and during\_hours | | or | Joins two conditions and is true if either condition is true. | repeat or during\_hours | | not | Inverts the following condition. | not during\_hours | | ( ) | Used for grouping. | mobile and (repeat or during\_hours) | Note that **and** is higher precedence than **or**. So if you use both in a condition like this: ``` mobile or repeat and during_hours ``` it is equivalent to this: ``` mobile or (repeat and during_hours) ```