With pyfbsdk::FBMessageBox you can pop up a modal dialog which waits for the user to click a button. It can contain up to three buttons and an option of never showing the dialog again.

Also see pyfbsdk::FBMessageBoxWithCheck and pyfbsdk::FBMessageBoxGetUserValue.

See the sample FBMessageBox.py, and many of the sample scripts use this function.