[FW][REF] sms marketing: restructure/add cards/remove essen.

content/applications/essentials/in_app_purchase.rst

@@ -89,7 +89,7 @@ settings. To use a service, simply interact with it wherever it appears in the d
    - :doc:`Lead mining <../sales/crm/acquire_leads/lead_mining>`
    - :doc:`Enrich your contacts base with Partner Autocomplete
      <../sales/crm/optimize/partner_autocomplete>`
-   - :doc:`SMS essentials <../marketing/sms_marketing/essentials/sms_essentials>`
+   - :doc:`SMS Marketing <../marketing/sms_marketing>`
 
 .. _in_app_purchase/credits:
 
@@ -119,7 +119,7 @@ Credits are purchased in *Packs* from the `Odoo IAP Catalog
    The number of credits consumed depends on the length of the SMS and the country of destination.
 
    For more information, refer to the :doc:`SMS Pricing and FAQ
-   <../marketing/sms_marketing/pricing/pricing_and_faq>` documentation.
+   <../marketing/sms_marketing/pricing_and_faq>` documentation.
 
 .. _iap/buying_credits:
 

content/applications/finance/accounting/payments/follow_up.rst

@@ -91,5 +91,5 @@ select :guilabel:`Process follow-ups`.
 
 .. seealso::
    - :doc:`/applications/essentials/in_app_purchase`
-   - :doc:`/applications/marketing/sms_marketing/pricing/pricing_and_faq`
+   - :doc:`/applications/marketing/sms_marketing/pricing_and_faq`
    - :doc:`../customer_invoices/snailmail`

content/applications/hr/recruitment.rst

@@ -89,7 +89,7 @@ feature is enabled.
 
 .. seealso::
    For more information, refer to the :doc:`SMS pricing and FAQs
-   <../marketing/sms_marketing/pricing/pricing_and_faq>` documentation.
+   <../marketing/sms_marketing/pricing_and_faq>` documentation.
 
 .. _recruitment/cv-display:
 

content/applications/marketing/email_marketing/mailing_lists.rst

@@ -38,8 +38,8 @@ can be filled out by following steps explained in the :doc:`Email Marketing doc
 <../email_marketing>`.
 
 Clicking :guilabel:`Send SMS` reveals a separate page with a blank SMS template form, which can be
-filled out by following steps explained in the :doc:`SMS essentials doc
-<../sms_marketing/essentials/sms_essentials>`.
+filled out by following steps explained in the :doc:`SMS Marketing doc
+<../sms_marketing>`.
 
 At the top of the mailing list form is a series of smart buttons that display a variety of metrics
 related to the specific mailing list. When any of the smart buttons are clicked, a separate page is

content/applications/marketing/marketing_automation/workflow_activities.rst

@@ -166,7 +166,7 @@ to the :guilabel:`Create Activities` pop-up window, in order to configure the :r
 <marketing_automation/trigger>`.
 
 .. seealso::
-   :doc:`Creating and configuring SMS templates <../sms_marketing/essentials/sms_essentials>`
+   :doc:`Creating and configuring SMS templates <../sms_marketing>`
 
 .. _marketing_automation/trigger:
 

content/applications/marketing/sms_marketing.rst

@@ -1,17 +1,83 @@
-:nosearch:
 :show-content:
-:hide-page-toc:
-:show-toc:
 
 =============
 SMS Marketing
 =============
 
+Utilizing :abbr:`SMS (Short Message Service)` outreach in communication strategies can help
+companies expand their market reach, especially in some countries, where emails might not be very
+common, or even used at all.
+
+Odoo's *SMS Marketing* application can also help boost conversion rates around valuable actions,
+such as event registrations, free trials, purchases, etc., since text and mobile-based marketing
+channels typically yield higher :abbr:`CTOR (click-to-open rate)` and :abbr:`CTR (click-through
+rate)` outcomes.
+
 .. seealso::
-   - `Odoo Tutorials: Marketing <https://www.odoo.com/slides/marketing-27>`_
+   `Odoo Tutorials: Marketing <https://www.odoo.com/slides/marketing-27>`_
+
+.. cards::
+
+   .. card:: Create SMS messages
+      :target: sms_marketing/create_sms
+
+      Explore how to create, configure, send, and schedule SMS messages.
+
+   .. card:: SMS analysis
+      :target: sms_marketing/sms_analysis
+
+      Examine detailed reporting metrics related to every aspect of sent SMS messages.
+
+   .. card:: SMS marketing campaigns
+      :target: sms_marketing/marketing_campaigns
+
+      Discover how to create and customize SMS marketing campaigns for any occasion with Odoo.
+
+   .. card:: Mailing lists and blacklists
+      :target: sms_marketing/mailing_lists_blacklists
+
+      Set up custom mailing lists and blacklists to ensure all SMS messages reach the right
+      recipients.
+
+   .. card:: Pricing and FAQ
+      :target: sms_marketing/pricing_and_faq
+
+      Find out more about Odoo's SMS pricing, and check out some of the most frequently asked
+      questions.
+
+SMS marketing dashboard
+=======================
+
+When the application is opened, Odoo displays the main :guilabel:`SMS Marketing` dashboard, which
+showcases the various SMS mailings that have been created, along with pertinent information and data
+related to that specific message.
+
+The :icon:`oi-view-kanban` :guilabel:`Kanban` view is the default Odoo uses when the application is
+opened, which provides an organized display of the SMS mailings that have been created, and what
+their current status is at the moment.
+
+.. note::
+   An :abbr:`SMS (Short Message Service)` mailing can have one of the following statuses:
+   :guilabel:`Draft`, :guilabel:`In Queue`, :guilabel:`Sending`, or :guilabel:`Sent`.
+
+In the upper right corner of the main :guilabel:`SMS Marketing` dashboard, there are a few different
+view options to choose from. Each one provides a unique take on the same SMS information.
+
+The :icon:`oi-view-list` :guilabel:`List` view provides the same useful data related to SMS
+mailings, but in a more traditional list layout.
+
+The :icon:`fa-calendar` :guilabel:`Calendar` view shows when SMS mailings are scheduled or have been
+sent. Clicking a future date opens a blank SMS template to be scheduled for that date.
+
+Lastly, the :icon:`fa-area-chart` :guilabel:`Graph` view visualizes that same SMS-related data in
+series of graphs and charts. Odoo also provides various ways to sort and group the data for more
+detailed analysis.
 
 .. toctree::
    :titlesonly:
 
-   sms_marketing/essentials
-   sms_marketing/pricing
+   sms_marketing/create_sms
+   sms_marketing/sms_analysis
+   sms_marketing/marketing_campaigns
+   sms_marketing/mailing_lists_blacklists
+   sms_marketing/pricing_and_faq

content/applications/marketing/sms_marketing/create_sms.rst

@@ -0,0 +1,117 @@
+===================
+Create SMS messages
+===================
+
+To start, click :guilabel:`Create` on the main :guilabel:`SMS Marketing` dashboard, and Odoo reveals
+a blank SMS template form, which can be configured in a number of different ways.
+
+.. image:: create_sms/sms-create.png
+   :align: center
+   :alt: Creating an SMS marketing template.
+
+First, give the mailing a :guilabel:`Subject`, which describes what the mailing is about.
+
+Next, in the :guilabel:`Recipients` field, choose to whom this :abbr:`SMS (Short Message Service)`
+will be sent. By default, Odoo has :guilabel:`Mailing List` selected. If this is the desired
+:guilabel:`Recipients` field option, specify which mailing list Odoo should send this :abbr:`SMS
+(Short Message Service)` to in the :guilabel:`Select Mailing List` field.
+
+.. note::
+   To create (or edit) a mailing list, go to :menuselection:`Mailing Lists --> Mailing List`. There,
+   Odoo displays all previously created mailing lists, along with various types of data related to
+   that specific list (e.g. number of contacts, mailings, recipients, etc.).
+
+   To learn more about mailing lists and contacts, check out :doc:`mailing_lists_blacklists`.
+
+.. image:: create_sms/sms-mailing-list.png
+   :align: center
+   :alt: View of the mailing list page in the SMS marketing application.
+
+To reveal all the possible options in the :guilabel:`Recipients` field, click the field to see all
+the choices Odoo makes available.
+
+When another field (other than :guilabel:`Mailing List`) is selected, the option to specify that
+chosen field even further becomes available — either with a default recipient filter equation that
+appears automatically (which can be customized to fit any business need), or, if no default
+recipient filter equation is present, an :guilabel:`Add Filter` button will appear.
+
+Clicking the :guilabel:`Add Filter` button, reveals fully customizable domain rule fields, which can
+be configured similar to an equation. You can create multiple recipient rules, if necessary.
+
+Then, Odoo will only send the :abbr:`SMS (Short Message Service)` to recipients who fit into
+whatever criteria is configured in those fields. Multiple rules can be added.
+
+.. example::
+   If :guilabel:`Contact` is chosen, all of the *Contacts* records in the Odoo database (vendors,
+   customers, etc.) will receive the :abbr:`SMS (Short Message Service)`, by default — unless more
+   specific recipient rules are entered.
+
+   For instance, the message below will only be sent to contacts in the database that are located in
+   the United States (e.g. `Country` > `Country Name` equals `United States`), and they haven't
+   blacklisted themselves from any mailings (e.g. `Blacklist` > `is` > `not set`).
+
+   .. image:: create_sms/contact-recipient.png
+      :align: center
+      :alt: Contact recipients on SMS marketing.
+
+Writing SMS messages
+--------------------
+
+Enter the content of the :abbr:`SMS (Short Message Service)` in the text field, found in the
+:guilabel:`SMS Content` tab. Links and emojis can also be included. Beneath the text field, Odoo
+displays how many characters are used in the message, along with how many :abbr:`SMS (Short Message
+Service)` mailings it will take to deliver the complete message.
+
+.. tip::
+   To check the price of sending an :abbr:`SMS (Short Message Service)` for a country, click on the
+   :guilabel:`Information` icon.
+
+.. image:: create_sms/sms-price-check.png
+   :align: center
+   :alt: SMS price check icon.
+
+.. note::
+   Credits must be purchased from Odoo in order to take advantage of the *SMS Marketing* app;
+   :abbr:`SMS (Short Message Service)` messages will not be sent without credits.
+
+.. seealso::
+   `Odoo SMS - FAQ <https://iap-services.odoo.com/iap/sms/pricing>`_
+
+Track links used in SMS messages
+--------------------------------
+
+When links are used in :abbr:`SMS (Short Message Service)` messages, Odoo automatically generates
+link trackers to gather analytical data and metrics related to those specific links, which can be
+found by going to :menuselection:`Configuration --> Link Tracker`.
+
+.. image:: create_sms/sms-link-tracker.png
+   :align: center
+   :alt: SMS Link Tracker page.
+
+Adjust SMS settings
+===================
+
+Under the :guilabel:`Settings` tab of the SMS template, there is an option to :guilabel:`Include
+opt-out link`. If activated, the recipient is able to unsubscribe from the mailing list, thus
+avoiding all future mailings.
+
+An employee can be designated as the :guilabel:`Responsible` in the :guilabel:`Tracking` section of
+the :guilabel:`Settings` tab, as well.
+
+.. image:: create_sms/sms-settings-tab.png
+   :align: center
+   :alt: SMS Settings tab.
+
+Send SMS messages
+=================
+
+Once a mailing is created, choose when Odoo should deliver the message from the following options:
+
+- :guilabel:`Send`: sends the message immediately. Consider using this option if the recipient list
+  is highly refined, or in cases that involve fast approaching deadlines, such as a "flash sale."
+- :guilabel:`Schedule`: choose a day (and time) for Odoo to send the mailing. This is typically the
+  best option for mailings related to a specific event. Such a method can also be used to promote a
+  limited-time offer, or to help plan a company's content strategy in advance.
+- :guilabel:`Test`: allows for an :abbr:`SMS (Short Message Service)` to be sent to one or multiple
+  numbers for test purposes. Remember to use a comma between phone numbers if multiple numbers are
+  used as recipients.