diff --git a/notifier.rst b/notifier.rst index 3bf2d34e34f..08c9e51dcb7 100644 --- a/notifier.rst +++ b/notifier.rst @@ -15,12 +15,14 @@ Get the Notifier installed using: $ composer require symfony/notifier .. _channels-chatters-texters-email-and-browser: +.. _channels-chatters-texters-email-browser-and-push: -Channels: Chatters, Texters, Email, Browser and Push ----------------------------------------------------- +Channels +-------- -The notifier component can send notifications to different channels. Each -channel can integrate with different providers (e.g. Slack or Twilio SMS) +Channels refer to the different mediums through which notifications can be delivered. +These channels can include email, SMS, chat services, push notifications, etc. +Each channel can integrate with different providers (e.g. Slack or Twilio SMS) by using transports. The notifier component supports the following channels: @@ -33,16 +35,16 @@ The notifier component supports the following channels: * Browser channel uses :ref:`flash messages `. * :ref:`Push channel ` sends notifications to phones and browsers via push notifications. -.. tip:: - - Use :doc:`secrets ` to securely store your - API tokens. - .. _notifier-sms-channel: SMS Channel ~~~~~~~~~~~ +The SMS channel uses :class:`Symfony\\Component\\Notifier\\Texter` classes +to send SMS messages to mobile phones. This feature requires subscribing to +a third-party service that sends SMS messages. Symfony provides integration +with a couple popular SMS services: + .. caution:: If any of the DSN values contains any character considered special in a @@ -50,11 +52,6 @@ SMS Channel encode them. See `RFC 3986`_ for the full list of reserved characters or use the :phpfunction:`urlencode` function to encode them. -The SMS channel uses :class:`Symfony\\Component\\Notifier\\Texter` classes -to send SMS messages to mobile phones. This feature requires subscribing to -a third-party service that sends SMS messages. Symfony provides integration -with a couple popular SMS services: - ================== ==================================================================================================================================== Service ================== ==================================================================================================================================== @@ -213,6 +210,11 @@ Service The `Sendinblue`_ integration is deprecated since Symfony 6.4, use the `Brevo`_ integration instead. +.. tip:: + + Use :doc:`Symfony configuration secrets ` to securely + store your API tokens. + .. tip:: Some third party transports, when using the API, support status callbacks