View source for ATC/Current/SDK/once

{{Article
|Standalone=No
|DisplayName=once
|TocName=once
|Context=To receive a notification for only the first SDK event for a particular type of activity, use ac('once').
|Dimension=EventsMethods
|ComingSoon=No
|Platform=PureConnect, GenesysCloud, GenesysEngage-cloud
|Section={{Section
|alignment=Vertical
|structuredtext={{NoteFormat|1=This article only applies to customers using {{Link-AnywhereElse|product=ATC|version=Current|manual=AdminGuide|topic=About_web_chats|display text=web chat}}. If you are a Genesys Cloud CX customer, we encourage you to use the new {{Link-AnywhereElse|product=ATC|version=Current|manual=AdminGuide|topic=About_web_messaging|display text=web messaging}} feature to replace web chat.|2=}}<br />
|Status=No
}}{{Section
|sectionHeading=Description
|anchor=Description
|alignment=Vertical
|structuredtext=Use ac('once') to subscribe to the first SDK event of a given event type and state.
|Status=No
}}{{Section
|sectionHeading=Signature
|anchor=Signature
|alignment=Vertical
|structuredtext=<syntaxhighlight lang="javascript">

ac('once', '<eventName>', function eventHandler(evt) { /* do stuff */ });
</syntaxhighlight>
|Status=No
}}{{Section
|sectionHeading=Example
|anchor=Example
|alignment=Vertical
|structuredtext=See:

*{{Link-SomewhereInThisVersion|manual=SDK|topic=Use_Events_methods_with_content_offers}}
*{{Link-SomewhereInThisVersion|manual=SDK|topic=Use_Events_methods_with_web_chats}}
|Status=No
}}
}}