Перейти к содержанию

Как форматировать текст и отправлять эмодзи через API?#

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

  1. Как форматировать текст и использовать управляющие символы?
  2. Как отправить смайлик (emoji) или другой символ?

1. Как форматировать текст и использовать управляющие символы?#

Форматирование сообщений и использование управляющих символов:

Форматирование Использование Описание
Курсивный текст _Курсивный текст_ Заключите текст между двумя знаками нижнего подчеркивания (_)
Жирный текст *жирный текст* Заключите текст между двумя звездочками (*)
Зачеркнутый текст ~зачеркнутый текст~ Заключите текст между двумя тильдами (~)
Моноширинный текст ```моноширинный текст``` Заключите текст между двумя тройными апострофами ("```")
Перенос текста на новую строку Перенос текста\nсимволом Без пробелов введите обратную косую черту с латинской буквой n в нижнем регистре ("\n") после слова где требуется сделать перенос текста на новую строку
Перенос текста табуляцией Перенос текста\tтабуляцией Без пробелов введите обратную косую черту с латинской буквой t в нижнем регистре ("\t") после слова где требуется сделать табуляцию
Перенос курсора в начало Перенос текста\rсимволом Без пробелов введите обратную косую черту с латинской буквой r в нижнем регистре ("\r") после слова где требуется переписать текст находящийся в начале строки

Данная информация подробно описана в официальной справке WhatsApp.

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

2. Как отправить смайлики emoji или другой символ?#

Cамый простой способ сделать это - использовать встроенные в вашу операционную систему emoji.

К сожалению, данный способ работает не везде.

Для этого поставьте курсор в поле для текста и используйте горячие клавиши:

  • Для Windows: Win + ю
  • Для MacOS: control + command + space

Затем выберите интересующий символ во всплывшем окне.

Если способ "Горячими клавишами" не сработал, и в вашем приложении горячие клавиши не работают, иногда самое простое решение - скопировать emoji из мессенджера, браузера или любого другого источника.

Пример: 😃😎🤯

Пример сайта с emoji.

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

Данный способ не работает напрямую из WhatsApp, WhatsApp Web, браузера или Личного кабинета.
Его можно использовать только для отправки текста в сыром виде через API (Postman, обработка 1С, строка в теле http запроса).

Чтобы отправить смайлики в WhatsApp из нашего API рекомендуем использовать UTF-16. Для этого, вам нужно представить символ в виде шестнадцатеричного числа или суррогатной пары, двух шестнадцатеричных чисел.

\uD83D\uDE01 - пример суррогатной пары

Эти числа есть в таблице символов Unicode..

Порядок предоставления символа в виде шестнадцатеричных чисел:

  1. Нажмите на значение столбца Unicode напротив выбранного смайлика.

    sending-emoji-1c.png

  2. Затем выберите столбец с суррогатными парами, например для смайлика 😁.

    sending-emoji-1c.png

  3. Чтобы указать что текст в кодировке Unicode (Unicode), введите обратную косую черту с латинской буквой u в нижнем регистре ("\u") перед каждым шестнадцатеричным числом.
    Например: D83D DE01 => \uD83D\uDE01

Пример отправки 😁 через обработку 1С

Отправив такую строку в API через обработку 1С, в WhatsApp вы отправите - 😁:

Вставьте суррогатную пару для нужного смайлика, в данном случае: \uD83D\uDE01

sending-emoji-1c.png

Результат в WhatsApp:

sending-emoji-1c.png

Использование интервалов между символами

Использование 16 битного представления символов позволяет использовать невидимые символы, которые обозначают интервал между буквами или цифрами. Это дает возможность, например, отправлять пустые сообщения или более тонко регулировать отступы.

Примеры интервальных символов:

\u00A0 - Non-Breaking Space empty-message-whatsapp.png
\u2000 - N пробел
\u2001 - M пробел
\u2002 - E пробел
\u2004 - Пробел в 3 ширины "M"
\u2005 - Пробел в 4 ширины "M"
\u2006 - Пробел в 6 ширин "M"
\u2007 - Цифровой пробел
\u2008 - Пробел для знаков препинания
\u2009 - Тонкий пробел
\u200A - Пробел в волос
\u2028 - Разделитель строк
\u205F - Среднее математическое пространство
\u3000 - Идеографический пробел