New response notifications

Where new responses are announced

The most common setting in a survey and the most common cause of "responses are coming in and nobody knows".

Reply to the person in the language they write in; write email subjects and texts in the language of the people who will read them.

1. See what is already set

get_quiz_email_settings shows whether survey emails are on, who receives them, whether each address is confirmed (the checked field) and the letter templates.

get_quiz_integrations shows whether Telegram is connected, switched on and allowed by the plan. The response also lists channels SurveyNinja does not offer; ignore them.

2. Email

• Turn the team notification on with toggle_quiz_email (type owner). The copy of the answers to the respondent is type client; it is not available on every plan, and the respondent's address comes from an email question or a variable set as client_source in save_quiz_email_template.
• Add a recipient with add_quiz_email_recipient. The number of addresses depends on the plan.
• The address must be confirmed. A letter with a code goes to it, and until it is confirmed nothing is delivered there, while the setting still looks complete. This is the single most common cause of "we set it up and get nothing". You cannot read that mailbox: ask the person for the code and confirm with confirm_quiz_email_recipient; its "resend_code" action sends a new one.
• Switch one address on or off with toggle_quiz_email_recipient; remove one with delete_quiz_email_recipient.
• What goes into the letter: set_quiz_email_questions lists the questions to leave out (the full list each time; an empty list brings every question back), and save_quiz_email_template sets the subject and text.

Do not put every question into the email when there are many: the contact and two or three key answers are more useful than the whole questionnaire.

3. Telegram

manage_quiz_messenger with messenger telegram. show lists the chats and people the messages go to, the subject and the excluded questions.

• activate switches sending on and returns a bot link. The person opens it and adds the bot to their chat or group; you cannot do that step for them, so give the link and the steps. No tokens are needed.
• "save_widgets" sets the subject and the questions to leave out of the message.
• test sends a test message. It is the best way to verify the setup without waiting for a live respondent.
• "remove_recipient" removes one chat; deactivate stops sending; delete removes the integration.

If Telegram is not on the person's plan, the tool says so: state it and stop.

If it stopped working

1. get_quiz_integrations: is Telegram switched off, not connected, or blocked by the plan?
2. For Telegram, get_integration_logs with integration telegram. The rejection text is there (bot removed from the group, chat deleted) together with the count of unsent messages.
3. For email, check that the address is confirmed and switched on in get_quiz_email_settings, and ask the person to look in their spam folder.
4. Once the cause is fixed, resend_integration_logs sends the Telegram backlog: one entry by log_id, or every failed one over a period. Resending earlier is pointless: the same rejection repeats.

What not to do

• Do not enable notifications the person switched off deliberately. Ask first.
• Do not resend before the cause is fixed.
• Do not add your own or a guessed address. Only the one the person gave.
• Do not suggest a plan upgrade or lead to payment. If a limit is hit, state the fact and stop.