WS Form Twilio - Плагин WordPress

Руководство по настройке WS Form Twilio для SMS-уведомлений из WordPress-форм

WS Form Twilio нужен не для того, чтобы просто добавить ещё одну форму на сайт. Его задача - связать форму WS Form с Twilio так, чтобы после сохранения или отправки заявки запускалось SMS-действие: администратор получал срочное уведомление, клиент получал короткое подтверждение, а команда могла быстрее реагировать на важные обращения.

В этом руководстве разобрана не рекламная карточка плагина, а практическая схема внедрения: что проверить перед установкой, как подключить Twilio, где настраивается действие Add to Twilio, как использовать переменные WS Form, зачем нужен opt-in, как протестировать результат и как диагностировать ошибки, если форма отправляется, но сообщение не приходит.

Материал рассчитан на владельца сайта, вебмастера или разработчика, который уже понимает ценность быстрых уведомлений, но хочет внедрить их аккуратно: без передачи секретов в публичные места, без отправки сообщений пользователям без согласия и без уверенности в неподтверждённых функциях.

Как работает связка формы, действия и Twilio

WS Form строит сценарий вокруг actions - действий, которые запускаются при сохранении, отправке формы или отдельном вызове через условную логику. Twilio add-on добавляет в этот механизм действие Add to Twilio. Поэтому интеграция не живёт отдельно от формы: она включается в общий порядок обработки заявки вместе с сохранением submission, показом сообщения, отправкой письма или перенаправлением.

Если упростить механику, пользователь заполняет форму, нажимает кнопку отправки, WS Form отправляет запрос через WordPress REST API, сервер обрабатывает настроенные действия, а затем браузер получает ответ. Если в цепочке есть Twilio-действие и его условия выполнены, плагин передаёт сообщение в Twilio с выбранного номера на указанный номер получателя. Главная точка контроля - не сама кнопка отправки, а действие внутри формы: именно там задаётся, когда отправлять SMS, с какого номера, кому и какой текст собирать.

Это важно для диагностики. Когда SMS не приходит, не всегда виноват Twilio. Ошибка может быть раньше: форма не отправилась, REST-ответ сломан PHP-предупреждением, действие отключено условной логикой, номер получателя подставлен пустым значением, opt-in не отмечен, лимит trial-аккаунта Twilio не позволяет отправить сообщение на непроверенный номер или текст разбился на несколько сегментов из-за символов вне GSM-алфавита.

Что именно добавляет Twilio add-on

По официальной документации add-on позволяет отправлять SMS из формы WS Form, создавать форму по Twilio phone number в один клик, отправлять текстовые сообщения и прикреплять файлы из upload-полей, signature-полей или медиатеки. В админке это выражается в двух рабочих зонах: глобальная вкладка Twilio в настройках WS Form и действие Add to Twilio внутри конкретной формы.

Вкладка настроек нужна для подключения учётных данных Twilio. Действие внутри формы нужно для бизнес-логики: когда запускать отправку, какой Twilio number использовать как отправителя, куда отправлять сообщение, какой текст собрать из полей и какие вложения добавить, если они действительно нужны.

Почему это не просто замена email-уведомлениям

Email остаётся полезным для длинных заявок, вложений, истории переписки и формального подтверждения. SMS лучше подходит для коротких событий, где скорость важнее полноты: новый лид, срочный запрос, заявка на обратный звонок, бронь, сигнал для дежурного менеджера. В WS Form Twilio эти два канала можно не противопоставлять: сохранение submission и email-действие остаются в форме, а SMS становится дополнительным быстрым сигналом.

Практический ориентир: не пытайтесь отправить в SMS всю заявку. В сообщение лучше вынести имя, телефон, короткую суть и внутреннюю ссылку на submission или страницу обработки, если такая ссылка есть в вашем рабочем процессе.

Кому подходит такой плагин, а кому лучше выбрать другой путь

WS Form Twilio особенно полезен там, где WS Form уже является основным конструктором форм, а SMS нужно запускать без внешнего сервиса автоматизации. Если на сайте несколько сложных форм, есть условная логика, поля с динамическими значениями, сохранение submissions и привычный процесс работы в WS Form, add-on позволяет встроить SMS в существующий сценарий без переноса формы в другую систему.

Подход хорошо ложится на сайты услуг, локальные бизнесы, сервисные заявки, записи на консультацию, обращения с высоким приоритетом, внутренние уведомления команды и простые клиентские подтверждения. В таких сценариях SMS не заменяет CRM и не строит полноценный центр сообщений, но закрывает важную задачу: быстро сообщить нужному человеку о событии из формы.

Когда WS Form Twilio будет удобен

• На сайте уже используется WS Form PRO, а формы не хочется переносить в другой конструктор.
• Нужно отправлять SMS после submit, save или при определённых условиях внутри формы.
• Текст сообщения должен собираться из полей формы через переменные вроде #field(123).
• Важна возможность выбрать Twilio sender number и контролировать opt-in перед отправкой пользователю.
• Команда хочет видеть submissions и action logs в WordPress, а не полагаться только на внешний журнал Twilio.

Когда стоит посмотреть в сторону альтернатив

Если у вас уже построена инфраструктура на Gravity Forms, WPForms, Formidable Forms или Fluent Forms, переход только ради SMS может быть невыгодным. У этих решений тоже есть Twilio-интеграции, но они отличаются логикой: где-то используется feed, где-то модуль интеграции, где-то action в форме, где-то отдельная вкладка Contact Form 7. Если форма простая и нужна только отправка SMS админу, отдельный SMS-плагин для уже выбранного конструктора может оказаться быстрее.

WS Form Twilio также не стоит воспринимать как платформу для массовой рассылки. Twilio Messaging Policy требует согласия получателя и понятного способа отказаться от сообщений, а сам SMS-канал имеет ограничения по длине, сегментам, географии и типу аккаунта. Для маркетинговых кампаний, подписочных списков, массовых уведомлений и сложной сегментации лучше использовать сервис, который специально проектировался под управление consent, шаблонами, отписками и журналом кампаний.

Что проверить перед установкой и подключением

Перед установкой полезно пройти короткую проверку. Она экономит время: большинство проблем с SMS-интеграциями начинается не в момент настройки сообщения, а раньше - когда не совпадает версия продукта, используется не тот аккаунт Twilio, trial-ограничения мешают тесту, у формы нет отдельного согласия на SMS или сообщение собирается из полей, которые пользователь может оставить пустыми.

Базовые условия

• На сайте должен быть установлен и работоспособен WS Form PRO, потому что add-ons требуют PRO-редакцию и не совместимы с Lite-редакцией.
• Twilio add-on должен быть установлен как отдельный add-on WS Form и активен в WordPress.
• У вас должен быть Twilio account с доступом к Account SID, Auth Token и SMS-enabled number.
• Если аккаунт Twilio тестовый, проверьте ограничения trial-режима: отправка может быть доступна только на проверенные номера и с ограничениями по стране и содержанию.
• В форме должен быть понятный opt-in, если SMS отправляется посетителю, а не только внутреннему сотруднику.

Проверка данных, которые попадут в SMS

SMS плохо переносит длинные, неструктурированные тексты. Twilio считает SMS по сегментам, а символы вне GSM-7, например часть типографских кавычек или эмодзи, могут переключить сообщение в UCS-2 и резко уменьшить длину одного сегмента. Поэтому до настройки действия стоит решить, какие поля действительно нужны в SMS и какие лучше оставить в email или submission.

Для типовой формы заявки достаточно короткого набора: имя, телефон, выбранная услуга, город или удобное время, плюс короткая фраза о сути обращения. Если в форме есть поле сообщения, не вставляйте его целиком без ограничения - длинный текст может превратиться в несколько SMS-сегментов и усложнить контроль расходов.

Согласие и ожидания пользователя

Документация WS Form рекомендует использовать отдельный unchecked opt-in checkbox для соответствия GDPR, а Twilio Messaging Policy требует предварительного согласия получателя и понятного объяснения, кто пишет, о чём будут сообщения и как отказаться. В руководстве это не юридическая консультация, но практический вывод простой: не отправляйте SMS посетителю только потому, что он указал телефон.

Если сообщение уходит только администратору сайта, opt-in пользователя может быть не нужен для внутреннего уведомления, но политика конфиденциальности всё равно должна объяснять, как обрабатывается телефон. Если SMS получает сам посетитель, добавьте отдельный чекбокс согласия рядом с полем телефона, не отмечайте его заранее и используйте это поле в настройке Opt-In Field.

Установка add-on и первая проверка в WordPress

Установка WS Form Twilio технически похожа на установку других add-ons WS Form: ZIP-файл загружается через Plugins, затем плагин активируется. Здесь не нужно описывать покупку, лицензионные ключи или обход активации - для руководства важнее рабочая часть после того, как add-on уже доступен в админке.

После активации проверьте, что в меню WordPress есть раздел WS Form, а в настройках появилась вкладка Twilio. Если вкладки нет, значит add-on не активен, установлен не тот ZIP-файл или сайт работает не с той редакцией WS Form. Не переходите к созданию формы, пока вкладка Twilio не появилась: иначе вы будете искать действие, которого в форме ещё нет.

Подключение Twilio credentials

1. Откройте WS Form в админ-панели WordPress.
2. Перейдите в Settings.
3. Откройте вкладку Twilio.
4. Введите Account SID и Auth Token из Twilio Console.
5. Сохраните настройки и убедитесь, что список Twilio numbers доступен в интерфейсе, если он используется при создании формы.

Auth Token нужно воспринимать как пароль. Не вставляйте его в публичные страницы, заметки в задаче, скриншоты для клиента или сообщения в поддержку без маскирования. Если есть подозрение, что token был раскрыт, используйте механизмы Twilio для ротации токена и затем обновите настройки в WS Form.

Первичный тест без реальной формы

Перед полноценным сценарием проверьте саму связку. Создайте черновую форму с минимальным набором полей, сохраните submission, убедитесь, что обычные действия формы работают, и только потом добавляйте Twilio. Такой порядок помогает разделить проблемы: сначала форма как WordPress/WS Form объект, потом SMS-интеграция.

Если тест проводится на trial-аккаунте Twilio, отправляйте первое сообщение на проверенный номер. Иначе ошибка может выглядеть как проблема WS Form, хотя ограничение находится на стороне Twilio.

Ключевая настройка действия Add to Twilio

Главная работа происходит в редакторе формы. Откройте форму, нажмите значок actions в верхней панели и добавьте действие Add to Twilio. После выбора действия появятся параметры, которые определяют поведение SMS. Не настраивайте их наугад: каждый параметр отвечает за конкретную часть маршрута сообщения.

Когда запускать действие

Параметр When Should This Action Run? определяет момент отправки: при сохранении, при отправке или в обоих случаях. Для большинства публичных заявок выбирайте отправку при submit, потому что save может означать черновик или промежуточный шаг. Отправка при save уместна только там, где сохранение формы само является рабочим событием, например в многошаговом внутреннем процессе.

Если действие должно запускаться только при выборе определённой услуги, региона или уровня срочности, не создавайте отдельную форму. Используйте условную логику actions: она может включить, отключить или немедленно запустить действие в зависимости от условий. Это особенно полезно для формы, где SMS нужен только для срочных обращений, а обычные заявки достаточно сохранить и отправить по email.

From и To

From выбирается из активных Twilio phone numbers. Это не произвольное поле для любого номера: отправитель должен быть доступен в Twilio и поддерживать нужный тип сообщений. To задаёт номер получателя. В него можно вписать статический номер сотрудника или подставить значение из поля формы через переменную WS Form.

Если SMS уходит администратору, статический номер проще и безопаснее. Если SMS уходит посетителю, используйте phone field и проверьте формат номера. Для международных сайтов лучше хранить номер в формате E.164 с кодом страны, потому что разные локальные записи вроде 8..., пробелы и скобки могут вести себя непредсказуемо при передаче во внешний сервис.

Opt-In Field

Поле Opt-In Field связывает отправку SMS с согласием пользователя. Хорошая форма не прячет это согласие в общей политике мелким текстом. Добавьте checkbox с одной опцией, оставьте его unchecked и подпишите понятно: что пользователь разрешает и какие сообщения может получить. Затем выберите этот checkbox как opt-in field в Twilio action.

Для внутренних уведомлений администратору opt-in field обычно не нужен, но для клиентских SMS это один из самых важных параметров. Если пользователь не отметил согласие, действие не должно отправлять сообщение ему, даже если номер заполнен.

Message и переменные WS Form

В поле Message можно вводить обычный текст и переменные WS Form. Переменная #field(123) подставляет значение поля с указанным ID. Это даёт гибкость, но требует дисциплины: если ID поля изменён, поле удалено или посетитель оставил его пустым, SMS может стать непонятным.

Хороший текст сообщения короткий, предсказуемый и не зависит от одного длинного textarea. Например:

Новая заявка: #field(123)
Телефон: #field(456)
Тема: #field(789)

Это не программный код, а шаблон сообщения. Его задача - собрать минимум нужной информации. После настройки отправьте тестовую заявку и проверьте не только факт доставки, но и итоговый текст: нет ли пустых строк, неправильного ID поля, слишком длинного значения или символов, которые неожиданно увеличивают число SMS-сегментов.

Вложения: когда использовать и когда отказаться

WS Form Twilio поддерживает field attachments и media attachments, включая upload-поля, signature-поля и файлы из медиатеки. Но вложения в SMS/MMS требуют осторожности: доступность MMS, поддержка оператора, размер файла, тип номера и регион могут отличаться. Если бизнес-задача не требует срочно отправлять файл в сообщение, лучше оставить вложение в submission или email, а в SMS отправить короткое уведомление о том, что файл приложен к заявке.

После сохранения действия сделайте контрольную отправку формы. Если форма показывает success message, но SMS не пришло, не меняйте сразу все параметры. Сначала проверьте submission и action logs, затем Twilio logs, затем ограничения аккаунта.

Автоформа по Twilio number и ручная сборка сценария

Официальная документация описывает два пути: автоматическое создание формы из вкладки Twilio на странице Add New и ручное добавление action к любой уже созданной форме. Оба пути полезны, но решают разные задачи.

Автоматический путь

Автоматическое создание формы подходит для быстрого старта. Вы открываете WS Form, нажимаете Add New, выбираете вкладку Twilio, кликаете по phone number и ждёте, пока WS Form создаст форму. По документации этот процесс не только создаёт форму, но и настраивает её для немедленного использования.

Это удобно, когда нужно быстро получить рабочую основу и затем доработать поля, текст сообщения и внешний вид. Но автоматический путь не освобождает от проверки: вы всё равно должны понять, какие поля попали в форму, какое действие создано, кому отправляется сообщение, есть ли opt-in и соответствует ли текст SMS реальной задаче.

Ручной путь

Ручная настройка лучше для существующих форм. Например, на сайте уже есть форма обратного звонка с conditional logic, email-уведомлением и сохранением submissions. В этом случае не нужно пересоздавать форму через Twilio tab. Откройте текущую форму, добавьте Add to Twilio, выберите момент запуска и свяжите текст сообщения с существующими полями.

Ручной путь требует больше внимания, зато даёт точный контроль. Вы можете отправлять SMS только для конкретной услуги, не отправлять сообщение при тестовом режиме, подставлять разные номера получателей через логику формы или оставить SMS только для срочных заявок.

Как выбрать путь

• Если формы ещё нет и нужно быстро проверить связку WS Form Twilio, начните с автоматического создания.
• Если форма уже опубликована и используется на сайте, добавляйте action вручную, чтобы не потерять существующие настройки.
• Если SMS должно зависеть от ответа пользователя, сразу планируйте conditional logic, а не плодите почти одинаковые формы.
• Если SMS отправляется клиенту, в обоих вариантах обязательно проверьте отдельное согласие и текст сообщения.

Практический пример: SMS для заявки на обратный звонок

Разберём сценарий, который часто встречается на сайтах услуг: посетитель оставляет имя, телефон, тему обращения и согласие на SMS, а менеджер получает короткое уведомление. Клиенту можно отправить подтверждение, но только если он явно согласился. Этот пример показывает не только что нажать, но и как проверить, что цепочка действительно работает.

Цель

Получить форму, которая сохраняет заявку в WS Form, уведомляет менеджера по SMS и, при отдельном согласии, отправляет посетителю короткое подтверждение. Основная ценность сценария - скорость реакции: менеджер видит заявку сразу, а подробности остаются в submission и email.

Подготовка

• WS Form PRO и Twilio add-on установлены и активны.
• Twilio credentials сохранены во вкладке Twilio.
• В Twilio есть SMS-enabled number, доступный как отправитель.
• Для теста подготовлен номер получателя, разрешённый текущим типом Twilio account.
• На странице сайта есть место, куда будет вставлена форма: блок, шорткод, виджет или page builder элемент, который уже используется вашим сайтом.

Шаги настройки

1. Создайте форму в WS Form или откройте существующую форму обратного звонка.
2. Добавьте поля: имя, телефон, тема обращения, короткий комментарий и checkbox согласия на SMS.
3. Проверьте, что у phone field понятная подпись и пользователь понимает, какой формат номера ожидается.
4. Откройте actions и оставьте Save Submission, чтобы заявка сохранялась в WordPress.
5. Добавьте action Add to Twilio для внутреннего уведомления менеджеру.
6. В When Should This Action Run? выберите submit, в From выберите Twilio number, в To укажите номер менеджера.
7. В Message соберите короткий текст из переменных полей: имя, телефон и тема обращения.
8. Если хотите отправить SMS клиенту, добавьте второе Twilio action или настройте отдельный сценарий, где To берётся из phone field, а Opt-In Field указывает на checkbox согласия.
9. Сохраните форму, опубликуйте её на тестовой странице и отправьте пробную заявку.

Проверка результата

После тестовой отправки проверьте три места. На публичной странице должно появиться ожидаемое сообщение об успешной отправке. В админке WS Form в submissions должна появиться заявка с данными и отметками actions. В Twilio Console должен быть виден запрос сообщения или причина отказа, если Twilio его не принял.

Если SMS пришло, но текст неудобен, не меняйте поля формы. Сначала отредактируйте шаблон Message: уберите лишние значения, сократите фразы, замените длинные кавычки и эмодзи, проверьте сегменты. Если SMS пришло администратору, но не пришло клиенту, отдельно проверьте opt-in, формат телефона и ограничения Twilio account.

Нюанс с двумя SMS-действиями

Для администратора и клиента лучше использовать два отдельных действия. У них разные цели, получатели, текст и условия. Внутреннее сообщение может содержать служебную фразу, а клиентское должно быть понятным, спокойным и соответствовать согласию. Такой подход проще диагностировать: в submissions видно, какое action сработало, а какое нет.

Практичные идеи применения без превращения SMS в рассылку

У WS Form Twilio есть несколько честных сценариев, где SMS действительно добавляет пользу. Важно не превращать каждую форму в источник сообщений. Чем точнее событие и короче текст, тем легче поддерживать интеграцию, контролировать согласие и понимать, что произошло при ошибке.

Сервисный сайт: быстрый сигнал менеджеру

Для формы обратного звонка или расчёта стоимости SMS можно отправлять только сотруднику. Используйте статический номер в To, короткий текст из полей имени, телефона и услуги, а подробности сохраняйте в submission. Ожидаемый результат - менеджер быстро видит важную заявку, но не получает длинный поток данных в SMS.

Проверка простая: отправьте тестовую заявку с разной услугой и убедитесь, что в SMS попадает именно та информация, по которой менеджер может быстро перезвонить. Если важность заявки зависит от выбранной услуги, добавьте conditional logic и запускайте SMS только для срочных категорий.

Запись на консультацию: подтверждение посетителю

Если посетитель оставляет телефон и явно соглашается на SMS, можно отправить короткое подтверждение: заявка получена, команда свяжется с ним, важная инструкция по подготовке. Не вставляйте в такое SMS персональные данные сверх необходимого. Лучше оставить подробности в email или на странице подтверждения.

Проверка: отправьте заявку без согласия и убедитесь, что клиентское SMS не уходит. Затем отметьте согласие и повторите тест. Это показывает, что Opt-In Field реально контролирует отправку, а не просто присутствует в форме.

Поддержка: маршрутизация срочных обращений

Для формы поддержки SMS уместно отправлять только по условию: например, если пользователь выбрал критичность проблемы или категорию, требующую дежурного реагирования. В этом сценарии WS Form conditional logic помогает не заваливать команду сообщениями по обычным вопросам.

Проверка: отправьте две заявки - обычную и срочную. Обычная должна сохраниться и отправиться по email, срочная дополнительно должна создать SMS. Если обе заявки отправляют SMS, значит условие слишком широкое или action не отключается в ветке ELSE.

Внутренний контроль: тест перед запуском рекламы

Перед рекламной кампанией часто важно убедиться, что форма, email и SMS работают вместе. Создайте временный внутренний тестовый сценарий, где SMS уходит только на номер администратора, а текст содержит отметку теста и название формы. После проверки отключите временное действие или ограничьте его условной логикой.

Такой сценарий полезен не потому, что add-on делает что-то необычное, а потому что он помогает проверить всю цепочку перед ростом трафика: публичная форма, REST-обработка, action, submission, Twilio request и полученное сообщение.

Проверка результата: где искать подтверждения и логи

Успешная настройка - это не только пришедшее SMS. В рабочем процессе должны быть следы, по которым можно понять, что произошло. WS Form сохраняет submissions и сведения об actions, а Twilio ведёт собственные журналы сообщений. Если использовать оба источника, диагностика становится гораздо спокойнее.

Submission в WS Form

Откройте submissions для нужной формы. В деталях заявки проверьте отправленные поля и блок actions. Документация WS Form описывает action icons: configuration, information, errors и re-run, если повторный запуск доступен для конкретного action. Это помогает отличить проблему данных формы от проблемы внешней отправки.

Если submission есть, значит форма дошла до серверной обработки. Если submission нет, сначала проверяйте саму форму, REST API, конфликт JavaScript, капчу, кеш или ошибки PHP. Нет смысла менять Twilio credentials, пока базовая отправка формы не работает.

Twilio Console

В Twilio Console проверьте message logs. Там обычно видно, был ли запрос принят, какой номер использован как отправитель, какой получатель указан и какая ошибка возникла на стороне Twilio. Для trial-аккаунта типичная причина отказа - попытка отправить на непроверенный номер или нарушение trial-ограничений.

Также проверьте длину текста. Twilio объясняет, что SMS разбивается на segments, а символы UCS-2 сокращают доступную длину одного сегмента. Для русскоязычных сообщений это особенно важно: кириллица, типографские кавычки и эмодзи могут сделать сообщение дороже и длиннее, чем кажется в поле редактора.

Debug Console в WS Form

Если форма отправляется с ошибкой, включите debug console только для администраторов. В документации WS Form этот инструмент используется для просмотра событий жизненного цикла формы и ошибок actions. После включения повторите отправку и посмотрите вкладки log/error.

Debug console не должен оставаться включённым для всех посетителей. Используйте его как инструмент диагностики, сохраните нужные сведения для себя и выключите или ограничьте после проверки.

Безопасные улучшения и аккуратная эксплуатация

Для WS Form Twilio лучший набор улучшений обычно находится не в PHP-сниппетах, а в аккуратной настройке формы, текста и условий. Публичных product-specific hooks для Twilio add-on в доступной документации недостаточно, поэтому здесь лучше не выдумывать код. Безопаснее использовать документированные переменные, conditional logic, submissions и настройки consent.

Сократите SMS-шаблон до полезного минимума

Внутреннее SMS должно отвечать на вопрос: кто обратился, как связаться и почему это срочно. Всё остальное пусть остаётся в submission или email. Для клиента SMS должно подтверждать действие и не раскрывать лишние данные. Такой подход снижает риск длинных segments, ошибок подстановки и случайной отправки чувствительной информации.

Разделите служебные и клиентские действия

Не пытайтесь одним action обслужить и менеджера, и клиента. Разные получатели требуют разных условий и разного текста. Два действия проще отключить, проверить, переименовать и найти в logs. Если одно действие ошибётся, второе можно анализировать отдельно.

Используйте условную логику вместо копирования форм

Когда SMS нужен только для части заявок, условная логика actions лучше, чем несколько почти одинаковых форм. Она сохраняет одну форму как источник истины, а различия переносит в правила: отправить SMS, не отправлять SMS, запустить action сразу при выполнении условия или оставить только обычную обработку.

Откат спорной настройки

Если после изменения SMS начали уходить не туда, текст стал пустым или клиенты получают лишние сообщения, самый быстрый безопасный откат - отключить конкретное Twilio action, а не удалять add-on целиком. После отключения отправьте тестовую заявку, убедитесь, что submission и email продолжают работать, затем исправьте параметры action и включите его обратно.

Почему SMS не приходит и как пройти диагностику

Проблемы с WS Form Twilio удобно разбирать по маршруту: форма, action, данные, Twilio account, доставка. Не начинайте с полной переустановки. Чаще достаточно найти уровень, на котором цепочка обрывается.

Форма не отправляется или показывает ошибку

Симптом: пользователь нажимает submit, но видит ошибку, а SMS не приходит. Возможная причина - не Twilio, а сбой самой отправки формы: JavaScript conflict, REST response с ошибкой, серверная validation error, PHP warning, капча или конфликт с кешированием.

Что проверить: откройте browser inspector и network response, включите WS Form debug console для администраторов, проверьте, создаётся ли submission. Если submission не появляется, сначала исправьте базовую отправку формы. Twilio action не сможет сработать над заявкой, которая не дошла до обработки.

Submission есть, но action не сработал

Симптом: заявка сохранена, но SMS нет и в Twilio Console нет попытки отправки. Возможная причина - action отключён, выбран неправильный момент запуска, условная логика не выполнена или opt-in field не отмечен.

Что проверить: откройте action configuration в submission, посмотрите, какое действие сработало, и сравните это с настройками формы. Если SMS должно отправляться только при определённом выборе, отправьте тест с подходящим и неподходящим значением. Так вы поймёте, ошибка в Twilio или в условии.

Twilio отклоняет сообщение

Симптом: в WS Form всё выглядит правильно, но в Twilio logs есть отказ. Возможные причины - trial-аккаунт отправляет на непроверенный номер, выбран номер отправителя без нужной возможности, формат получателя неправильный, географические разрешения не позволяют отправку или сообщение не соответствует политике.

Что проверить: отправьте тест на проверенный номер, используйте международный формат, проверьте sender number, message logs и ограничения текущего аккаунта. Если проблема появляется только на одном направлении или стране, ищите ограничение в Twilio, а не в форме.

SMS приходит, но текст пустой или неправильный

Симптом: сообщение доставляется, но внутри нет имени, телефона или темы. Обычно это ошибка переменных. ID поля в #field(123) может не соответствовать текущему полю, поле может быть необязательным, а условная логика могла скрыть его от пользователя.

Что проверить: откройте layout editor и найдите реальные ID полей, сравните их с шаблоном Message, отправьте тест с заполнением всех значений. Если поле не всегда заполняется, добавьте в текст нейтральную формулировку или не используйте это поле в SMS.

Сообщение отправляется слишком часто

Симптом: менеджер получает SMS по каждому сохранению, черновику или повторной отправке. Возможная причина - action настроен на save и submit одновременно, условная логика слишком широкая или форма используется в сценарии, где пользователь сохраняет прогресс.

Что проверить: оставьте submit как основной момент отправки, если save не является рабочим событием. Для срочных обращений добавьте условие. Если действие временно мешает работе, отключите его и проверьте, что остальные actions продолжают выполняться.

Сообщение стало дороже или разбивается на части

Симптом: в Twilio logs видно несколько segments для одного короткого по смыслу сообщения. Причина часто в длине текста или символах UCS-2. Русские символы, типографские кавычки, эмодзи и некоторые знаки могут влиять на сегментацию.

Что проверить: сократите текст, уберите эмодзи и декоративные символы, оставьте только нужные поля. Для внутренних уведомлений можно использовать латиницу в служебных метках, но не жертвуйте понятностью команды. Главное - контролировать итоговый текст до запуска на реальном трафике.

Когда WS Form Twilio будет удачным выбором

WS Form Twilio имеет смысл использовать, когда на сайте уже есть WS Form PRO и нужно добавить быстрые SMS-уведомления к конкретным формам без переноса логики в другой конструктор. Сильная сторона решения - работа через actions: можно выбрать момент запуска, собрать текст из переменных, связать отправку с opt-in и диагностировать результат через submissions.

Перед запуском проверьте четыре вещи: add-on активен, Twilio credentials сохранены безопасно, тестовая форма создаёт submission, а SMS уходит на разрешённый номер с понятным коротким текстом. После этого можно постепенно расширять сценарий: добавить клиентское подтверждение, условную логику для срочных заявок или отдельные действия для разных ролей команды.

Если этот рабочий процесс подходит вашему сайту, можно перейти к блоку загрузки и получить версию для WordPress, затем развернуть его сначала на тестовой копии сайта. Не запускайте SMS на живом трафике до тех пор, пока не проверены consent, формат номера, logs и откат настройки.