Обзор

SurveyAnalytica позволяет подключить собственный номер телефона от Telnyx или Twilio для отправки и приёма SMS в рамках ваших кампаний и рабочих процессов. После подключения ответы от контактов будут поступать напрямую в раздел переписки.

Прежде чем начать

• Номер телефона, приобретённый у Telnyx или Twilio.
• API-учётные данные для этого номера (см. Шаг 2 ниже).
• Рабочее пространство в SurveyAnalytica, к которому будет привязан номер.

Шаг 1: приобретите номер телефона

Если у вас ещё нет номера, приобретите его у выбранного провайдера:

• Telnyx — поиск и покупка номеров в портале Telnyx
• Twilio — поиск и покупка номеров в консоли Twilio

Запишите полный номер в международном формате, например +14155551234.

Шаг 2: получите свои API-учётные данные

Telnyx

1. Войдите в портал Telnyx.
2. Перейдите в Auth > API Keys.
3. Нажмите Create API Key (или скопируйте существующий ключ, начинающийся с KEY...).
4. Скопируйте полный ключ — вы вставите его в поле API Key в SurveyAnalytica.

Twilio

1. Войдите в консоль Twilio.
2. На главной панели найдите свои Account SID и Auth Token.
3. Объедините их в формате AccountSID:AuthToken (через двоеточие, без пробелов).
4. Вставьте это объединённое значение в поле API Key в SurveyAnalytica.

Шаг 3: подключите номер в SurveyAnalytica

1. Перейдите в Account > Domains & Numbers и откройте вкладку SMS.
2. Заполните форму подключения:

Поле	Что вводить
Provider	Выберите Telnyx или Twilio в соответствии с вашим номером.
Phone Number (E.164)	Ваш номер в международном формате, например +14155551234. Должен начинаться с +, за которым следует код страны.
API Key	Ваш API-ключ Telnyx (KEY...) или ваш AccountSID:AuthToken Twilio.
Display Name (необязательно)	Понятное название, например Support Line. Если оставить поле пустым, по умолчанию используется номер телефона.

3. Нажмите Connect. Если учётные данные неверны, появится сообщение об ошибке — проверьте API-ключ и попробуйте снова.

Шаг 4: привяжите номер к рабочему пространству

Каждый подключённый номер можно привязать к одному рабочему пространству. Как только номер появится в списке:

1. Используйте раскрывающийся список Assign to workspace на карточке номера.
2. Нажмите Save.

Теперь номер доступен при создании SMS-кампаний или переписок в этом рабочем пространстве.

Статус webhook

На каждой карточке номера отображается значок Webhook Active или Webhook Not Configured, который обновляется автоматически.

• Webhook Active — входящие ответы и обновления доставки принимаются корректно.
• Webhook Not Configured — SurveyAnalytica не удалось зарегистрировать обработчик входящих сообщений у провайдера. Убедитесь, что API-ключ всё ещё действителен, затем попробуйте удалить и заново добавить номер.

Удаление номера

Нажмите Delete на карточке номера, чтобы отключить его. Номер останется в вашем аккаунте Telnyx или Twilio, но перестанет принимать входящие сообщения в SurveyAnalytica.

Устранение неполадок

Симптом	Что проверить
“Failed to connect number” error	Убедитесь, что API-ключ верный и не истёк. Для Twilio проверьте, что формат — AccountSID:AuthToken без лишних пробелов.
Phone number rejected	Убедитесь, что номер указан в формате E.164: начинается с +, затем код страны, затем номер — без пробелов и дефисов.
Webhook Not Configured после подключения	Подождите немного, пока значок обновится. Если он остаётся оранжевым, удалите и заново подключите номер с новым API-ключом.
Входящие сообщения не отображаются	Убедитесь, что номер привязан к нужному рабочему пространству и что значок webhook показывает Active.