diff --git a/_config.yml b/_config.yml index 86c8bf39..4719995d 100644 --- a/_config.yml +++ b/_config.yml @@ -226,7 +226,12 @@ collections: order: - troubleshooting-overview.md - troubleshooting-checklist.md + - why-a-message-did-not-send.md + - troubleshoot-whatsapp-templates.md + - troubleshoot-a-capture.md - troubleshoot-missing-signals-or-activity.md + - troubleshoot-pages-that-do-not-load.md + - contact-hellotext-support.md - sms-sending-limits-for-new-businesses.md output: true diff --git a/_i18n/en/captures/capture-overview.md b/_i18n/en/captures/capture-overview.md index a51be342..01a18f15 100644 --- a/_i18n/en/captures/capture-overview.md +++ b/_i18n/en/captures/capture-overview.md @@ -40,6 +40,8 @@ Name each capture after the placement or campaign where it will be used. This ma Test every capture before sharing it with customers. For QR codes, scan the final printed or displayed version with a phone. For links and forms, test the full subscription flow from the same device a customer would use. +If a capture does not appear, complete its interaction, or update the customer profile, follow [Troubleshoot a capture that does not appear or register customers]({% link _troubleshooting-deliverability/troubleshoot-a-capture.md %}). + For webchat, test the launcher, teaser, opening sequence, Inbox ownership, and any WhatsApp handoff from both desktop and mobile. ## Next steps diff --git a/_i18n/en/troubleshooting-deliverability/contact-hellotext-support.md b/_i18n/en/troubleshooting-deliverability/contact-hellotext-support.md new file mode 100644 index 00000000..cfdbec86 --- /dev/null +++ b/_i18n/en/troubleshooting-deliverability/contact-hellotext-support.md @@ -0,0 +1,88 @@ +You can contact the Support team through [hellotext.com/contact](https://www.hellotext.com/contact/) or by emailing [support@hellotext.com](mailto:support@hellotext.com). + +A specific report makes it easier to identify the affected business, object, and time. You do not need to diagnose the technical cause before asking for help. + +## Before contacting Support + +When possible: + +1. Reproduce the problem once and note the exact stage where it occurs. +2. Review the related guide in this section. +3. Confirm whether it affects one teammate, customer profile, message, or page, or whether it is broader. +4. Preserve any recent changes that may be related. +5. Avoid repeating actions that could send messages, create campaigns, charge, import, or modify data more than once. + +If incorrect messages continue to send and you can do so without losing information, pause the affected campaign, playbook, or journey while it is investigated. + +## Basic information to include + +Include: + +- business name in Hellotext; +- exact URL of the affected page; +- approximate date and time with time zone; +- what you expected to happen; +- what happened instead; +- scope of the problem; +- short steps to reproduce it; +- a screenshot or short recording; and +- recent configuration, integration, permission, or code changes. + +Keep the conversation in the same email or request thread when adding evidence about the same problem. Open a separate request for a different problem. + +## Information by problem type + +| Problem | Useful information | +| --- | --- | +| **Message or channel** | Channel, sender, message ID or link, customer profile, delivery status, and reason. | +| **Campaign** | Campaign link, audience, schedule, and stage where it stopped. | +| **Playbook or journey** | Link, relevant version or configuration, expected signal, and customer profile used for testing. | +| **Inbox** | Conversation link, expected team or teammate, status, and assignment time. | +| **Integration** | Connected platform, store, or account, missing object, source-system identifier, and last known sync. | +| **Capture** | Type and name, URL or placement, device, browser, and stage where it stopped. | +| **Report or attribution** | Report, period, time zone, filters, order or conversion, and expected result. | +| **API or Hellotext.js** | Endpoint or event, time, request ID, response code, and the smallest snippet that reproduces the problem. | +| **Billing** | Month, invoice, plan, or affected charge concept. Use identifiers, not complete payment details. | + +You can partially mask a phone number or email when the complete identifier is not needed to find the case. + +## Information not to send + +Do not share: + +- passwords; +- API tokens or application secrets; +- verification codes; +- cookies or authorization headers; +- complete card or bank account numbers; or +- full customer exports when one or two examples are enough. + +If Support needs a sensitive file, first confirm what information is required and how to send it securely. + +## How to describe impact + +Describe the observable impact without trying to assign a technical severity. + +For example: + +- how many businesses, teammates, or customers are affected; +- whether it blocks an operation or has a temporary workaround; +- whether it prevents receiving or sending messages; +- whether it could create duplicate messages, changes, or charges; and +- how long it has been happening. + +Report any suspected unauthorized access, data exposure, or credential misuse immediately. Do not include the potentially exposed secrets in the message. + +## What to expect next + +Support may ask for another example, confirm permission to inspect an object, or ask you to reproduce the problem with technical evidence. Reply in the same thread to preserve context. + +The public contact page does not define one universal response time. If your plan or agreement includes a specific support commitment, that commitment is the applicable reference. Do not use the SLAs configured for your Inbox conversations as the expected Hellotext Support response time: they are different metrics. + +## Related guides + +- [Troubleshooting and deliverability overview]({% link _troubleshooting-deliverability/troubleshooting-overview.md %}) +- [Troubleshooting checklist]({% link _troubleshooting-deliverability/troubleshooting-checklist.md %}) +- [Troubleshoot pages that do not load]({% link _troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md %}) +- [Why a message did not send]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}) +- [Troubleshoot missing signals or activity]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}) diff --git a/_i18n/en/troubleshooting-deliverability/troubleshoot-a-capture.md b/_i18n/en/troubleshooting-deliverability/troubleshoot-a-capture.md new file mode 100644 index 00000000..9d4b20c0 --- /dev/null +++ b/_i18n/en/troubleshooting-deliverability/troubleshoot-a-capture.md @@ -0,0 +1,118 @@ +Use this guide when a capture playbook is not available in the product, does not load for a customer, does not register submitted information, or does not start the configured action after capture. + +All capture playbooks are under **Playbooks > Explore playbooks**, in the **Captures** group. They include different experiences: Website Popup, Website Form, Webchat Widget, QR codes, shareable links, checkout opt-in, and AI interactions such as Subscriber Booster and Property Collector. + +## Identify where it stopped + +Before changing the configuration, reproduce the problem and place it in one of these stages: + +| Stage | What you observe | +| --- | --- | +| **Availability** | The playbook is missing from **Explore playbooks** or shown as **On request**. | +| **Loading** | The capture exists but does not appear on the expected website, checkout, or channel. | +| **Interaction** | The capture appears but does not open, advance, or submit. | +| **Verification** | The customer submitted information but must still verify a new phone number or email. | +| **Customer profile** | The interaction finished, but the information is not on the expected customer profile. | +| **Next action** | The profile was updated, but a coupon was not delivered, a journey did not start, or a message was not sent. | + +This separation keeps you from reinstalling a capture when the problem is a pending verification or a later action. + +## If the playbook is not available + +1. Open **Playbooks** and click **Explore playbooks**. +2. Find the **Captures** group. +3. Confirm that the playbook is available for your business and plan. +4. If it is shown as **On request**, disabled, or not yet available, check with your Hellotext team before preparing the installation. + +After configuring it, confirm that it was saved and enabled. Popups and forms published on a website must also complete their installation or publishing step. + +## If a popup or Webchat does not appear + +Check these points in order: + +1. Confirm that the playbook is enabled and its latest version was saved. +2. Confirm that the supported integration, plugin, or Hellotext.js loads on the live page. +3. For a manual installation, compare the code running on the website with the current code generated by Hellotext. +4. Check the exact domain and URL where it should appear. +5. Confirm that the configuration includes the device you are testing. +6. Check whether the experience opens automatically, after a delay, or only when someone clicks a launcher, bubble, or teaser. +7. Test in a private browser window and on a real phone to separate previous session state from an installation problem. +8. Check whether website styles, consent banners, or other elements are hiding the capture. + +For a Subscriber Booster teaser, both **Webchat Widget** and **Subscriber Booster** must be enabled. Webchat provides the visible entry point, while the other playbook handles the AI subscription invitation. + +## If a form does not load + +First, test the hosted link for the same form. + +- If the hosted link works, inspect the installation, container, and website styles or scripts where the form is embedded. +- If the hosted link also fails, inspect the form configuration, required fields, and status in Hellotext. + +For an embedded form, confirm that the current snippet is present and that the eCommerce integration or Hellotext.js loads successfully. A developer can also observe `forms:collected` to confirm that the library found the form definitions and `form:completed` to confirm that the process finished, including any required verification. + +## If a QR code or link does not register the subscription + +Scan or open the final version from a phone and confirm that it uses the expected number, channel, message, and capture reference. + +Opening the QR code or link does not complete the subscription. The customer must send the prefilled message through SMS or WhatsApp. Hellotext records the capture and updates the customer profile after receiving that message. + +If the message does not leave the phone or reach Hellotext, inspect the channel and number before changing the capture. + +## If checkout opt-in does not register the customer + +Confirm that: + +- the eCommerce integration is connected and syncing orders and customer profiles; +- the consent option is visible in the published checkout; +- the customer selected the relevant option; and +- you are checking consent for the correct channel on the customer profile. + +Creating a profile from a purchase does not mean that the customer accepted marketing messages. Subscription status depends on the consent they provided at checkout. + +## If data is missing from the customer profile + +1. Repeat the test with a phone number or email that you can safely inspect. +2. Complete every required field. +3. If Hellotext sends verification to a new phone number or email, complete it. The process is not finished while that verification is pending. +4. Search for the customer profile using every identifier submitted. Hellotext may update an existing profile or merge matching profiles instead of creating a new one. +5. Check that custom properties used by the capture still exist and match the configured fields. +6. Confirm that consent was requested for the channel you are checking. + +The same browser can remember a completed capture. Use a private window when you need to repeat the experience from the beginning. + +## If the next action failed + +A completed capture and a later action are separate stages. + +- If the customer profile was updated but a coupon or message was not delivered, review [Why a message did not send]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}). +- If a journey should have started, confirm that the journey is enabled and inspect its activity. +- If a Webchat conversation should have opened, confirm that the message reaches Inbox and inspect its assignment. +- If Subscriber Booster did not participate, confirm that the conversation started through Webchat or was initiated by the customer on WhatsApp, and that the playbook is enabled. + +Do not use message delivery as the only test of whether capture failed. First confirm whether the profile and consent were updated. + +## What to include when asking for help + +Include: + +- business and capture name; +- capture type; +- URL, domain, or placement tested; +- device and browser; +- approximate date and time with time zone; +- exact stage where it stopped; +- customer profile identifier used for the test; +- a screenshot or short recording; and +- visible console errors or failed network requests, if you have technical access. + +Do not include verification codes, tokens, passwords, or real payment information. + +## Related guides + +- [Capture tools overview]({% link _captures/capture-overview.md %}) +- [Website Popup]({% link _captures/website-popup.md %}) +- [Website Form]({% link _captures/forms.md %}) +- [Webchat Widget playbook]({% link _captures/webchat-widget-playbook.md %}) +- [Subscriber Booster playbook]({% link _captures/subscriber-booster-playbook.md %}) +- [Who you can message]({% link _audience/consent-and-subscriber-status.md %}) +- [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/en/troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md b/_i18n/en/troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md new file mode 100644 index 00000000..49ae1c26 --- /dev/null +++ b/_i18n/en/troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md @@ -0,0 +1,80 @@ +Use this guide when a Hellotext page is blank, remains in a loading state, shows incomplete information, responds slowly, or repeatedly shows the same error. + +## Before reloading + +First, preserve the information that will make the problem easier to investigate: + +- copy the full URL; +- note the selected business; +- record the approximate date and time with time zone; +- take a screenshot of the visible message or state; and +- note the last action performed. + +If the error appeared while sending a campaign, importing data, changing billing, or performing another action that could create duplicate results, confirm its status before repeating it. + +## Define the scope + +Check how broad the problem is: + +1. Does one page fail, or do all Hellotext pages fail? +2. Does one business fail, or does it also happen after switching businesses? +3. Does it affect one teammate or several people? +4. Is the page blank, or does it load with data that does not match the filters? +5. Did it start after a role, integration, browser, or network change? + +A page that loads without results is not always experiencing a technical failure. Check the period, time zone, filters, business, and permissions before treating it as an outage. + +## Recover the page + +Try these steps in order and check again after each one: + +1. Reload the page once. +2. Open the same URL in a private window in the same browser. +3. Confirm that your connection can open other pages and that a VPN, proxy, or corporate filter is not blocking Hellotext. +4. Try another updated browser or network when your team policy allows it. +5. Sign out and back in if the problem appears limited to your session. +6. Temporarily disable privacy or content-blocking extensions for the test when it is safe to do so. + +Clear site data only after preserving evidence and any unsaved work. This signs you out and removes local browser preferences, but it does not delete information stored in your Hellotext business. + +## Check permissions and context + +If general navigation works but one page does not: + +- confirm that you are in the correct business; +- check whether your role can access that setting or report; +- open the page from Hellotext navigation instead of an old bookmark; +- remove filters to see whether the view returns data; and +- check whether the linked object still exists and remains available to your business. + +An access error, an empty data view, and a technical loading failure need different solutions. Preserve the exact warning text. + +## Collect technical evidence + +If you can use browser developer tools: + +1. Open **Console** and **Network** before reproducing the problem. +2. Reload the page and repeat the action once. +3. Preserve the text of the first relevant error. +4. In **Network**, identify failed requests and note the URL, method, status, and time. + +A HAR file can contain customer identifiers, message content, cookies, or authorization headers. Do not share it unless Support requests it and you have confirmed a secure way to send it. + +## When to contact Support + +Contact Support when: + +- the problem also happens in a private window and another browser or network; +- it affects multiple teammates or businesses; +- it blocks access to Inbox, channels, campaigns, playbooks, billing, or essential data; +- an action remains in an uncertain state and repeating it could create duplicates; or +- you see repeated server errors or failed requests that you cannot resolve. + +Use [Contact Hellotext Support]({% link _troubleshooting-deliverability/contact-hellotext-support.md %}) to gather the information needed. + +## Related guides + +- [Troubleshooting checklist]({% link _troubleshooting-deliverability/troubleshooting-checklist.md %}) +- [Troubleshoot missing signals or activity]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}) +- [Troubleshoot a capture that does not appear or register customers]({% link _troubleshooting-deliverability/troubleshoot-a-capture.md %}) +- [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/en/troubleshooting-deliverability/troubleshoot-whatsapp-templates.md b/_i18n/en/troubleshooting-deliverability/troubleshoot-whatsapp-templates.md new file mode 100644 index 00000000..3be51634 --- /dev/null +++ b/_i18n/en/troubleshooting-deliverability/troubleshoot-whatsapp-templates.md @@ -0,0 +1,139 @@ +Use this guide when a campaign, route, playbook, or reply cannot send through WhatsApp because its template is under review, was rejected, lost quality, or is no longer available in Meta. + +Templates make it possible to initiate WhatsApp messages outside the 24-hour customer service window. Hellotext prepares and synchronizes the content, but Meta controls each template's final approval, category, quality, and availability. + +## First identify the state + +Open the affected campaign, route, or template and review its WhatsApp state. You can also go to **Settings → Templates** to find it and inspect its change history. + +The most important states are: + +- **Meta review:** Meta has not decided on that version yet. +- **Active or approved:** the version can be used to send. +- **Rejected by Meta:** that version cannot be used until it is corrected and resubmitted. +- **Flagged by Meta:** quality has declined and the template risks being paused or disabled. +- **Paused by Meta:** the template cannot be used temporarily. +- **Disabled:** Meta no longer allows that template to be used. +- **Requires your attention:** an imported template contains parameters that Hellotext could not convert into customer properties. + +Do not confuse the campaign state with the template state. A campaign can be scheduled while still waiting for approval of its WhatsApp content. + +## The template is under review + +Meta reviews new templates and some changes. Approval time can vary, so leave room for review before an important campaign. + +While an edit is pending: + +- if an approved version already exists, messages can continue using that active version; +- if the template is new and has no approved version, messages that require it must wait; and +- the new version becomes active automatically when Meta approves it. + +Do not make repeated changes while Meta is reviewing the same version. Check the preview, category, links, buttons, and examples first, then group corrections before resubmitting. + +## The template was rejected + +Open the template and review the WhatsApp feedback. Correct the stated reason before saving it again for approval. + +Check especially that: + +- the message has a clear purpose and matches its category; +- the content cannot be interpreted as abusive, deceptive, or a scam; +- a utility template describes an expected interaction or update and does not hide a promotion; +- the text does not start or end with a personalization tag; +- properties and examples produce a complete, understandable sentence; +- links and buttons match what the message promises; and +- the business and reason for contact are recognizable to the customer. + +An existing WhatsApp template cannot be renamed. If you need a different name or substantially different purpose, create a new template. + +Saving the correction submits it to Meta again. Do not schedule the send until the new version appears as approved. + +## Meta changed the category + +Meta can reclassify a template when it determines that the content belongs to another category. This can change how the message is used and charged. + +Review the notice in Hellotext. You can: + +- edit the content so it clearly matches the intended category and resubmit it; or +- appeal the change in Meta when you believe the classification is incorrect. + +The category of an approved template cannot be changed directly in Hellotext. When you need another category, you generally need to create a new template or follow Meta's appeal process. + +## The template is flagged or lost quality + +Meta evaluates signals such as blocks, reports, and read rates. A flagged template may remain available, but it risks being paused or disabled. + +Before using it broadly again: + +- confirm that the audience expects the message; +- reduce repetitive or irrelevant sends; +- make it clear who is writing and why; +- check that frequency and timing make sense; and +- use more specific segmentation when the content does not apply to everyone. + +Changing a few words does not correct the wrong audience. Review content, consent, and the reason for sending together. + +## The template is paused or disabled + +A paused or disabled template should not be used for new sends. + +- If it is **paused**, review quality and wait for the recovery indicated by Meta before reactivating it. +- If it is **disabled**, use another approved template or create a suitable new version. +- If a message already failed for this reason and Hellotext offers another eligible channel, you can choose it when content and consent are compatible. + +Do not repeatedly retry the same template while it retains that state. Retrying does not change Meta's decision. + +## The template was deleted or is missing in Meta + +A template can exist in Hellotext but have been deleted or become unavailable in the connected WhatsApp account. + +Confirm that: + +- the business is still connected to the correct WhatsApp account; +- the number and WhatsApp Business account remain active; +- the template exists in Meta for that number, language, and name; and +- it was not deleted by another user or integration. + +When Hellotext indicates that Meta no longer has the approved template, confirm whether it was deleted before resubmitting it. If the approved template was deleted, select another active template, create a new template with a different name, or wait 30 days before reusing the deleted name. Otherwise, save the changes to submit it for approval again. + +## Imported parameters require attention + +A template imported from WhatsApp can contain variables that Hellotext cannot automatically associate with customer properties. + +Edit the template and replace each parameter with a compatible property or fixed content. Use the preview to confirm that every value produces an understandable result before saving. + +Changes to how variables are completed inside Hellotext do not always require another Meta review when the approved template content does not change. The state shown in Hellotext indicates whether that version returned to review. + +## A campaign is still waiting + +If the campaign uses WhatsApp: + +1. Open the campaign and confirm whether it is **Under review**, **WhatsApp review**, **Scheduled**, or rejected. +2. Open the associated template and review its state and feedback. +3. Correct the content only if it was rejected or requires attention. +4. Confirm that the scheduled date is still valid after approval. +5. Send a test when the template is active. + +A WhatsApp test with new content can also wait until Meta approves the template. The test does not bypass review. + +## What to include when asking for help + +Include: + +- affected business and WhatsApp number; +- template name and link; +- campaign, route, or playbook that is trying to use it; +- language and category; +- exact state and feedback from Meta; +- time of the latest change; and +- screenshot of the preview and notice. + +Do not include tokens, passwords, or Meta payment information. + +## Related guides + +- [WhatsApp channel fundamentals]({% link _numbers/whatsapp-channel-fundamentals.md %}) +- [Connect WhatsApp]({% link _integrations/connect-whatsapp.md %}) +- [Create a campaign]({% link _campaigns/creating-a-campaign.md %}) +- [Why a message did not send]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}) +- [Who can you message?]({% link _audience/consent-and-subscriber-status.md %}) diff --git a/_i18n/en/troubleshooting-deliverability/troubleshooting-checklist.md b/_i18n/en/troubleshooting-deliverability/troubleshooting-checklist.md index 6a573ae2..6842104f 100644 --- a/_i18n/en/troubleshooting-deliverability/troubleshooting-checklist.md +++ b/_i18n/en/troubleshooting-deliverability/troubleshooting-checklist.md @@ -21,6 +21,8 @@ Check the sender, consent for that channel, account access, balance or plan limi Keep reading: +- [Why a message did not send]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}) +- [Troubleshoot WhatsApp templates]({% link _troubleshooting-deliverability/troubleshoot-whatsapp-templates.md %}) - [Messaging channels overview]({% link _numbers/messaging-overview.md %}) - [SMS sending limits for new businesses]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}) - [Connect WhatsApp]({% link _integrations/connect-whatsapp.md %}) @@ -64,4 +66,6 @@ Keep reading: ## When you contact support -Include the business name, the affected customer profile, the channel, the campaign, playbook, conversation, or report link, the approximate time, what you expected, what happened instead, and any screenshots or recent setup changes. +If a page does not load, preserve its URL, the time of the error, and the last action before reloading. Follow [Troubleshoot pages that do not load]({% link _troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md %}). + +Include the business name, the affected customer profile, the channel, the campaign, playbook, conversation, or report link, the approximate time, what you expected, what happened instead, and any screenshots or recent setup changes. Review [Contact Hellotext Support]({% link _troubleshooting-deliverability/contact-hellotext-support.md %}) before sending sensitive information. diff --git a/_i18n/en/troubleshooting-deliverability/troubleshooting-overview.md b/_i18n/en/troubleshooting-deliverability/troubleshooting-overview.md index 175d09c9..683e1460 100644 --- a/_i18n/en/troubleshooting-deliverability/troubleshooting-overview.md +++ b/_i18n/en/troubleshooting-deliverability/troubleshooting-overview.md @@ -1,11 +1,13 @@ Use this section when something in Hellotext does not look right and you need to narrow down where to check first. -Troubleshooting usually starts in one of four places: +Troubleshooting usually starts in one of these places: - Setup and integrations. - Channels and message delivery. - Tracking, reporting, and attribution. - Inbox operations and team workflows. +- Captures and website experiences. +- Page access and loading. If you are not sure where the issue belongs, start with the [troubleshooting checklist]({% link _troubleshooting-deliverability/troubleshooting-checklist.md %}). @@ -19,8 +21,12 @@ Keep reading: [Setup and integrations overview]({% link _integrations/setup-over If a message is not delivered, first check the channel used, sender configuration, consent, available balance or plan access, and any temporary sending limits. +Start here: [Why a message did not send]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}). + For SMS-specific limits on new prepaid businesses, keep reading: [SMS sending limits for new businesses]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}). +If the issue is a WhatsApp template under review, rejected, flagged, or paused, use [Troubleshoot WhatsApp templates]({% link _troubleshooting-deliverability/troubleshoot-whatsapp-templates.md %}). + For channel setup context, keep reading: [Messaging channels overview]({% link _numbers/messaging-overview.md %}). ## Campaigns @@ -44,3 +50,17 @@ If the issue is specific to one playbook, use [Troubleshoot a playbook that did If conversations are not being handled by the right person, or response performance looks off, check assignment, roles, ownership, and response-time configuration. Keep reading: [Inbox and conversations overview]({% link _team/inbox-overview.md %}). + +## Captures and website experiences + +If a popup, form, Webchat, QR code, link, or checkout opt-in does not appear or register the customer, first identify whether the problem is availability, installation, interaction, verification, the customer profile, or a later action. + +Start here: [Troubleshoot a capture that does not appear or register customers]({% link _troubleshooting-deliverability/troubleshoot-a-capture.md %}). + +## Page access and loading + +If a page is blank, does not finish loading, or shows the same error, preserve the URL and time of the problem before reloading. + +Start here: [Troubleshoot pages that do not load]({% link _troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md %}). + +If the problem continues, review [Contact Hellotext Support]({% link _troubleshooting-deliverability/contact-hellotext-support.md %}). diff --git a/_i18n/en/troubleshooting-deliverability/why-a-message-did-not-send.md b/_i18n/en/troubleshooting-deliverability/why-a-message-did-not-send.md new file mode 100644 index 00000000..18d0ea0a --- /dev/null +++ b/_i18n/en/troubleshooting-deliverability/why-a-message-did-not-send.md @@ -0,0 +1,156 @@ +Use this guide when you expected a message from a campaign, playbook, route, conversation, or integration, but it did not send or did not reach the customer. + +Start by finding the message or the activity that should have created it. Your next step depends on whether the message never existed, is still processing, or ended with a delivery error. + +## First identify what happened + +### The message was never created + +If you cannot find a message, you are not dealing with a delivery failure yet. Check its source: + +- **Campaign:** confirm that it is not still a draft, under review, or scheduled, and that the customer profile was eligible for the selected audience and channels. +- **Playbook:** confirm that it triggered, the opportunity is still valid, and Hellotext decided to send at that time. +- **Route:** review the trigger, conditions, waits, branches, and the step that should send. +- **Inbox:** confirm that the reply was sent and did not remain an internal note or draft. +- **API:** confirm that the request was accepted, then review the actual message state. A `status: received` response confirms receipt of the request, not delivery to the customer. + +For automations, see [Troubleshoot a playbook that did not trigger or send]({% link _journeys/troubleshoot-a-playbook-that-did-not-trigger-or-send.md %}). If the activity that should start the flow is missing, use [Troubleshoot missing signals or activity]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}). + +### The message is pending or routed + +A message can exist without a final confirmation yet: + +- `pending` means it is waiting for processing; +- `routed` means it was sent to the external provider; and +- `delivered` means the provider confirmed delivery. + +Check the message time and allow a reasonable processing period before retrying. A provider delay does not always end in failure, and creating another message too soon can produce a duplicate. + +### The message appears as not sent + +Open the message in the conversation and read the reason shown next to **Not sent**. Hellotext normalizes the channel response to explain what prevented delivery and, when appropriate, can offer **Try again**, **Choose channel**, or an action that corrects the account. + +The exact reason is more useful than the general state. Record it before changing settings. + +## Customer data and consent + +Do not retry a message when the customer profile is unsubscribed. The opt-out must be respected for every send that depends on that consent. + +Also check that the customer profile has a valid identity for the channel: + +- a complete and correct phone number for SMS or WhatsApp; +- an account that is reachable through the corresponding channel; and +- a block and subscription state compatible with the message. + +If the customer has another available channel, Hellotext may let you choose it for a new attempt. An alternative channel does not bypass its consent rules. + +See [Who can you message?]({% link _audience/consent-and-subscriber-status.md %}) to distinguish identity, verification, reachability, and subscription. + +## Billing and account limits + +The message can be blocked when the business needs to: + +- add or update a payment method; +- add funds or enable automatic top-up; +- increase a recharge limit; or +- resolve a daily or monthly message limit. + +Correct the indicated condition before retrying. If the reason is a temporary daily limit, wait until sending is allowed again. For new SMS accounts, see [SMS sending limits for new businesses]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}). + +## Channel or sender problems + +Confirm that the channel is still connected and active, the selected sender belongs to the business, and the integration retains the required permissions. + +A setup that worked before can stop working if an account is disconnected, a permission changes, Meta restricts a number, or the provider becomes temporarily unavailable. + +Do not change the content or automation until you confirm whether the reason belongs to the channel. See [Messaging channels overview]({% link _numbers/messaging-overview.md %}) to return to the corresponding setup. + +## WhatsApp reasons + +Common reasons include: + +- **24-hour window closed:** a free-form message can no longer be sent. Use an approved template or an available alternative channel. +- **Number unreachable:** Meta could not deliver to the customer's number. +- **Marketing limited or opted out:** Meta limited the marketing message or the customer indicated that they do not want it. +- **Template paused or disabled:** use another approved template or correct its status in Meta. +- **Display name pending:** Meta must approve the name before sending is enabled. +- **Permissions, registration, policies, or payment:** review the account and number in Meta. +- **Sending limit or service temporarily unavailable:** wait before retrying. +- **Active experiment:** Meta may exclude that message from a delivery experiment. If Hellotext offers another eligible channel, you can use it. + +Do not immediately repeat a send limited by Meta. Correct the condition or wait for the indicated period first. For content that is still under review or rejected, check the template state before scheduling the campaign again. + +## SMS reasons + +An SMS can appear as undelivered when: + +- the carrier reported that it did not reach the recipient; +- the provider canceled the send; +- the number is invalid or unavailable; or +- the provider had a temporary problem. + +Check the international number format and avoid repeatedly sending to destinations that the carrier marked as unreachable. If the problem was temporary and Hellotext shows **Try again**, wait a few minutes and retry once. + +## Mercado Libre reasons + +Mercado Libre can prevent sending because of: + +- the time or limits on seller-initiated conversations; +- the payment or fulfillment state; +- a buyer block; +- an active mediation; or +- guest-shop restrictions. + +These reasons depend on the operation or conversation state in Mercado Libre. Correct or wait for that state before retrying; changing the message text does not remove the restriction. + +## The message was no longer relevant + +Some playbook messages are intentionally canceled before sending because the opportunity changed. For example: + +- the customer completed the cart or purchased the product; +- the product is out of stock or no longer available; +- the checkout URL is missing; +- a newer price change replaced the earlier one; or +- the order that originated a reminder was canceled or refunded. + +Do not retry the message in these cases. The cancellation prevents outdated information or unnecessary contact after the customer already converted. + +## Decide whether to retry + +Retry only when: + +- the reason was temporary; +- you corrected the setup, payment, or permissions; and +- Hellotext shows a valid option to retry or choose another channel. + +Do not retry when: + +- the customer is unsubscribed or blocked messages; +- the destination is definitively unreachable; +- the message no longer applies because of a purchase, cancellation, or product change; or +- the platform prohibits that message type in the current conversation. + +After retrying, confirm that the new message reaches `delivered`. Do not use repeated retries to work around a cause that is still active. + +## What to include when asking for help + +If the reason is not enough to resolve the problem, include: + +- business name; +- link to the customer profile and conversation; +- source campaign, playbook, route, or integration; +- channel and sender; +- date, time, and time zone; +- exact reason shown under **Not sent**; +- result of any retry; and +- screenshot and recent setup changes. + +Do not include API tokens, passwords, or complete payment details. + +## Related guides + +- [Troubleshooting checklist]({% link _troubleshooting-deliverability/troubleshooting-checklist.md %}) +- [Troubleshoot a playbook that did not trigger or send]({% link _journeys/troubleshoot-a-playbook-that-did-not-trigger-or-send.md %}) +- [How Hellotext decides whether a playbook can send]({% link _journeys/how-hellotext-decides-whether-a-playbook-can-send.md %}) +- [Create a campaign]({% link _campaigns/creating-a-campaign.md %}) +- [Send SMS with the API]({% link _developers/send-sms-with-api.md %}) diff --git a/_i18n/es/captures/capture-overview.md b/_i18n/es/captures/capture-overview.md index 0a0c2319..8dd96d06 100644 --- a/_i18n/es/captures/capture-overview.md +++ b/_i18n/es/captures/capture-overview.md @@ -40,6 +40,8 @@ Nombra cada captura según la ubicación o campaña donde se va a usar. Esto per Prueba cada captura antes de compartirla con clientes. Para códigos QR, escanea con un teléfono la versión final impresa o publicada. Para links y formularios, prueba el flujo completo desde el mismo tipo de dispositivo que usaría un cliente. +Si una captura no aparece, no completa la interacción o no actualiza el perfil del cliente, sigue [Soluciona una captura que no aparece o no registra clientes]({% link _troubleshooting-deliverability/troubleshoot-a-capture.md %}). + Para webchat, prueba el lanzador, teaser, secuencia inicial, ownership en Inbox y cualquier derivación a WhatsApp desde desktop y mobile. ## Próximos pasos diff --git a/_i18n/es/troubleshooting-deliverability/contact-hellotext-support.md b/_i18n/es/troubleshooting-deliverability/contact-hellotext-support.md new file mode 100644 index 00000000..75cc3be2 --- /dev/null +++ b/_i18n/es/troubleshooting-deliverability/contact-hellotext-support.md @@ -0,0 +1,88 @@ +Puedes contactar al equipo de soporte mediante [hellotext.com/contact](https://www.hellotext.com/contact/) o escribiendo a [support@hellotext.com](mailto:support@hellotext.com). + +Un reporte concreto permite identificar antes el negocio, objeto y momento afectados. No es necesario diagnosticar la causa técnica antes de pedir ayuda. + +## Antes de contactar + +Cuando sea posible: + +1. Reproduce el problema una vez y anota la etapa exacta donde ocurre. +2. Revisa la guía relacionada en esta sección. +3. Confirma si afecta a una sola persona, perfil del cliente, mensaje o página, o si es general. +4. Conserva los cambios recientes que puedan estar relacionados. +5. Evita repetir acciones que podrían enviar mensajes, crear campañas, cobrar, importar o modificar datos más de una vez. + +Si mensajes incorrectos continúan enviándose y puedes hacerlo sin perder información, pausa la campaña, playbook o ruta afectada mientras se investiga. + +## Información básica que debes incluir + +Incluye: + +- nombre del negocio en Hellotext; +- URL exacta de la página afectada; +- fecha y hora aproximadas con zona horaria; +- qué esperabas que ocurriera; +- qué ocurrió en su lugar; +- alcance del problema; +- pasos breves para reproducirlo; +- captura de pantalla o grabación breve; y +- cambios recientes de configuración, integración, permisos o código. + +Mantén la conversación en el mismo hilo de email o solicitud cuando agregues evidencia sobre el mismo problema. Abre otra solicitud cuando se trate de un problema diferente. + +## Información según el problema + +| Problema | Información útil | +| --- | --- | +| **Mensaje o canal** | Canal, remitente, ID o link del mensaje, perfil del cliente, estado y motivo de entrega. | +| **Campaña** | Link de la campaña, audiencia, programación y etapa donde se detuvo. | +| **Playbook o ruta** | Link, versión o configuración relevante, señal esperada y perfil del cliente usado para probar. | +| **Inbox** | Link de la conversación, equipo o persona esperada, estado y momento de la asignación. | +| **Integración** | Plataforma, tienda o cuenta conectada, objeto faltante, identificador en el sistema de origen y última sincronización conocida. | +| **Captura** | Tipo y nombre, URL o ubicación, dispositivo, navegador y etapa donde dejó de funcionar. | +| **Reporte o atribución** | Reporte, período, zona horaria, filtros, pedido o conversión y resultado esperado. | +| **API o Hellotext.js** | Endpoint o evento, hora, ID de solicitud, código de respuesta y fragmento mínimo que reproduce el problema. | +| **Facturación** | Mes, factura, plan o concepto afectado. Usa identificadores, no datos completos de pago. | + +Puedes ocultar parte del teléfono o email cuando el identificador completo no sea necesario para encontrar el caso. + +## Información que no debes enviar + +No compartas: + +- contraseñas; +- tokens de API o secretos de aplicaciones; +- códigos de verificación; +- cookies o encabezados de autorización; +- números completos de tarjetas o cuentas bancarias; ni +- exportaciones completas de clientes cuando basta con uno o dos ejemplos. + +Si soporte necesita un archivo sensible, confirma primero qué información hace falta y cómo enviarla de forma segura. + +## Cómo indicar el impacto + +Describe el impacto observable sin intentar asignar una severidad técnica. + +Por ejemplo: + +- cuántos negocios, personas del equipo o clientes están afectados; +- si el problema bloquea una operación o tiene una alternativa temporal; +- si impide recibir o enviar mensajes; +- si puede producir mensajes, cambios o cargos duplicados; y +- desde cuándo ocurre. + +Reporta inmediatamente cualquier sospecha de acceso no autorizado, exposición de datos o uso indebido de credenciales. No incluyas los secretos potencialmente expuestos en el mensaje. + +## Qué esperar después + +Soporte puede pedirte un ejemplo adicional, confirmar permisos para revisar un objeto o solicitar que reproduzcas el problema con evidencia técnica. Responde en el mismo hilo para conservar el contexto. + +La página de contacto pública no define un tiempo universal de respuesta. Si tu plan o acuerdo incluye un compromiso específico de soporte, ese compromiso es la referencia aplicable. Evita usar los SLA configurados para las conversaciones de tu Inbox como si fueran el tiempo de respuesta del soporte de Hellotext: son métricas distintas. + +## Guías relacionadas + +- [Resumen de solución de problemas y entregabilidad]({% link _troubleshooting-deliverability/troubleshooting-overview.md %}) +- [Checklist de solución de problemas]({% link _troubleshooting-deliverability/troubleshooting-checklist.md %}) +- [Soluciona páginas que no cargan]({% link _troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md %}) +- [Por qué no se envió un mensaje]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}) +- [Soluciona señales o actividad faltante]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}) diff --git a/_i18n/es/troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md b/_i18n/es/troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md index 2d90c640..2015bbaf 100644 --- a/_i18n/es/troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md +++ b/_i18n/es/troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md @@ -6,7 +6,7 @@ Si tu negocio aún está en revisión, puedes enviar hasta 50 SMS cada 24 horas. Los carriers y los destinatarios responden mejor a negocios que envían mensajes relevantes y esperados. El límite temporal le da tiempo a Hellotext para revisar la calidad de tus envíos, incluyendo aspectos como: -- Si los perfiles de cliente tienen una razón clara para recibir tus mensajes. +- Si los perfiles de clientes tienen una razón clara para recibir tus mensajes. - Si el contenido coincide con tu negocio y la relación con el cliente. - Si los mensajes evitan patrones spammy, confusos o de volumen inusual. - Si tus envíos mantienen bajas las bajas y quejas. @@ -41,7 +41,7 @@ No. Los negocios con acuerdo de crédito ya tienen una relación comercial de co ## Preguntas frecuentes -### ¿Puedo seguir usando WhatsApp, Instagram, Webchat, Journeys y el Inbox? +### ¿Puedo seguir usando WhatsApp, Instagram, Webchat, Rutas y el Inbox? Sí. El límite temporal de revisión solo afecta el envío por SMS. Las demás funciones de Hellotext siguen funcionando según tu plan y configuración de canales. diff --git a/_i18n/es/troubleshooting-deliverability/troubleshoot-a-capture.md b/_i18n/es/troubleshooting-deliverability/troubleshoot-a-capture.md new file mode 100644 index 00000000..e49cec48 --- /dev/null +++ b/_i18n/es/troubleshooting-deliverability/troubleshoot-a-capture.md @@ -0,0 +1,118 @@ +Usa esta guía cuando un playbook de captura no aparece en el producto, no carga para el cliente, no registra la información enviada o no inicia la acción configurada después de la captura. + +Todos los playbooks de captura se encuentran en **Playbooks > Explorar playbooks**, dentro del grupo **Capturas**. Incluyen experiencias distintas: Popup de Sitio Web, Formulario de Sitio Web, Widget de Webchat, códigos QR, links compartibles, opt-in en checkout e interacciones con IA como Impulsor de Suscriptores y Recolector de Propiedades. + +## Identifica dónde se detuvo + +Antes de cambiar la configuración, reproduce el problema y ubícalo en una de estas etapas: + +| Etapa | Qué observas | +| --- | --- | +| **Disponibilidad** | El playbook no aparece en **Explorar playbooks** o figura como **A solicitud**. | +| **Carga** | La captura existe, pero no aparece en el sitio, checkout o canal esperado. | +| **Interacción** | La captura aparece, pero no abre, no avanza o no permite enviar. | +| **Verificación** | El cliente envió sus datos, pero todavía debe verificar un teléfono o email nuevo. | +| **Perfil del cliente** | La interacción terminó, pero la información no aparece en el perfil esperado. | +| **Acción posterior** | El perfil se actualizó, pero no llegó un cupón, no comenzó una ruta o no se envió un mensaje. | + +Esta separación evita reinstalar una captura cuando el problema está en una verificación pendiente o en una acción posterior. + +## Si el playbook no está disponible + +1. Abre **Playbooks** y haz clic en **Explorar playbooks**. +2. Busca el grupo **Capturas**. +3. Confirma que el playbook esté disponible para tu negocio y plan. +4. Si aparece como **A solicitud**, deshabilitado o todavía no está disponible, consulta con tu equipo de Hellotext antes de preparar la instalación. + +Después de configurarlo, confirma que se haya guardado y habilitado. Los popups y formularios que se publican en un sitio también deben completar su paso de instalación o publicación. + +## Si un popup o Webchat no aparece + +Revisa en este orden: + +1. Confirma que el playbook esté habilitado y que la versión más reciente se haya guardado. +2. Confirma que la integración compatible, el plugin o Hellotext.js cargue en la página real. +3. Si la instalación es manual, compara el código que se ejecuta en el sitio con el código actual generado por Hellotext. +4. Revisa el dominio y la URL exactos donde debería aparecer. +5. Confirma que la configuración incluya el dispositivo que estás usando. +6. Revisa si la experiencia se abre automáticamente, después de una demora o solamente al hacer click en un lanzador, burbuja o teaser. +7. Prueba en una ventana privada y en un teléfono real para separar el estado de una sesión anterior de un problema de instalación. +8. Revisa si estilos, banners de consentimiento u otros elementos del sitio ocultan la captura. + +Para el teaser de Impulsor de Suscriptores, tanto **Widget de Webchat** como **Impulsor de Suscriptores** deben estar habilitados. El webchat es la entrada visible y el otro playbook maneja la invitación de suscripción con IA. + +## Si un formulario no carga + +Primero prueba el link alojado del mismo formulario. + +- Si el link alojado funciona, revisa la instalación, el contenedor y los estilos o scripts de la página donde integraste el formulario. +- Si tampoco funciona el link alojado, revisa la configuración, los campos requeridos y el estado del formulario en Hellotext. + +Para un formulario integrado, confirma que el snippet actual esté presente y que la integración de eCommerce o Hellotext.js cargue correctamente. Un desarrollador también puede observar `forms:collected` para confirmar que la librería encontró las definiciones y `form:completed` para confirmar que el proceso terminó, incluida la verificación requerida. + +## Si un código QR o link no registra la suscripción + +Escanea o abre la versión final desde un teléfono y confirma que use el número, canal, mensaje y referencia esperados. + +Abrir el código QR o link no completa la suscripción. El cliente debe enviar el mensaje prellenado desde SMS o WhatsApp. Hellotext registra la captura y actualiza el perfil del cliente después de recibir ese mensaje. + +Si el mensaje no sale del teléfono o no llega a Hellotext, revisa el canal y el número antes de cambiar la captura. + +## Si el opt-in de checkout no registra al cliente + +Confirma que: + +- la integración de eCommerce esté conectada y sincronizando pedidos y perfiles de clientes; +- la opción de consentimiento esté visible en el checkout publicado; +- el cliente haya seleccionado la opción correspondiente; y +- revises el consentimiento del canal correcto en el perfil del cliente. + +Crear un perfil a partir de una compra no significa que el cliente haya aceptado mensajes de marketing. El estado de suscripción depende del consentimiento que completó en el checkout. + +## Si los datos no aparecen en el perfil del cliente + +1. Repite la prueba con un teléfono o email que puedas revisar de forma segura. +2. Completa todos los campos obligatorios. +3. Si Hellotext envía una verificación a un teléfono o email nuevo, complétala. El proceso todavía no terminó mientras esa verificación esté pendiente. +4. Busca el perfil del cliente por cada identificador enviado. Hellotext puede actualizar un perfil existente o combinar perfiles coincidentes en lugar de crear uno nuevo. +5. Revisa que las propiedades personalizadas usadas por la captura todavía existan y correspondan con los campos configurados. +6. Confirma que el consentimiento se haya solicitado para el canal que estás revisando. + +El mismo navegador puede recordar una captura completada. Usa una ventana privada cuando necesites repetir el recorrido desde cero. + +## Si falló lo que debía pasar después + +Una captura completada y una acción posterior son etapas diferentes. + +- Si el perfil del cliente se actualizó pero no llegó un cupón o mensaje, revisa [Por qué no se envió un mensaje]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}). +- Si debía comenzar una ruta, confirma que la ruta esté habilitada y revisa su actividad. +- Si debía abrirse una conversación de Webchat, confirma que el mensaje llegue al Inbox y revisa la asignación correspondiente. +- Si Impulsor de Suscriptores no intervino, confirma que la conversación haya empezado desde Webchat o por iniciativa del cliente en WhatsApp y que el playbook esté habilitado. + +No uses la entrega de un mensaje como única prueba de que la captura falló. Primero confirma si el perfil y el consentimiento se actualizaron. + +## Qué incluir al pedir ayuda + +Incluye: + +- negocio y nombre de la captura; +- tipo de captura; +- URL, dominio o ubicación probada; +- dispositivo y navegador; +- fecha y hora aproximadas con zona horaria; +- etapa exacta donde se detuvo; +- identificador del perfil del cliente usado para la prueba; +- captura de pantalla o grabación breve; y +- errores visibles en la consola o solicitudes de red fallidas, si tienes acceso técnico. + +No incluyas códigos de verificación, tokens, contraseñas ni datos reales de pago. + +## Guías relacionadas + +- [Resumen de herramientas de captura]({% link _captures/capture-overview.md %}) +- [Popup de Sitio Web]({% link _captures/website-popup.md %}) +- [Formulario de Sitio Web]({% link _captures/forms.md %}) +- [Playbook Widget de Webchat]({% link _captures/webchat-widget-playbook.md %}) +- [Playbook Impulsor de Suscriptores]({% link _captures/subscriber-booster-playbook.md %}) +- [A quién puedes enviar mensajes]({% link _audience/consent-and-subscriber-status.md %}) +- [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/es/troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md b/_i18n/es/troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md index 78ad1fa2..8626eece 100644 --- a/_i18n/es/troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md +++ b/_i18n/es/troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md @@ -137,7 +137,7 @@ Sigue leyendo: | El evento nunca aparece | Sync de integración, Hellotext.js, request de API, nombre de acción o ambiente | | El evento aparece pero el segmento no cambia | Reglas del segmento, ventana de tiempo, nombres de propiedades o momento de actualización | | El playbook no empezó | Disparador, audiencia, elegibilidad del canal, consentimiento, condiciones de detención o estado activo | -| Las métricas del reporte se ven bajas | Links con tracking, rango de fechas, reglas de atribución, canal, audiencia u órdenes sincronizadas | +| Las métricas del reporte se ven bajas | Links con tracking, rango de fechas, reglas de atribución, canal, audiencia o pedidos sincronizados | | El mensaje de WhatsApp/SMS no se envió | Configuración del canal, remitente, consentimiento, plantilla, límites o estado de entrega | ## Cuando contactes a soporte diff --git a/_i18n/es/troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md b/_i18n/es/troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md new file mode 100644 index 00000000..f0616e35 --- /dev/null +++ b/_i18n/es/troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md @@ -0,0 +1,80 @@ +Usa esta guía cuando una página de Hellotext queda vacía, muestra una carga que no termina, presenta información incompleta, responde lentamente o vuelve a mostrar el mismo error. + +## Antes de recargar + +Conserva primero la información que permitirá investigar el problema: + +- copia la URL completa; +- anota el negocio seleccionado; +- registra la fecha y hora aproximadas con zona horaria; +- toma una captura del mensaje o estado visible; y +- anota la última acción realizada. + +Si el error apareció al enviar una campaña, importar datos, cambiar facturación o ejecutar otra acción que puede crear resultados duplicados, confirma su estado antes de repetirla. + +## Define el alcance + +Comprueba qué tan amplio es el problema: + +1. ¿Falla una sola página o todas las páginas de Hellotext? +2. ¿Falla un solo negocio o también ocurre al cambiar de negocio? +3. ¿Le ocurre a una sola persona o a varias personas del equipo? +4. ¿La página queda vacía o carga, pero los datos no coinciden con los filtros? +5. ¿Comenzó después de un cambio de rol, integración, navegador o red? + +Una página que carga sin resultados no siempre tiene un problema técnico. Revisa el período, zona horaria, filtros, negocio y permisos antes de tratarla como una página caída. + +## Recupera la página + +Prueba en este orden y vuelve a revisar después de cada paso: + +1. Recarga la página una vez. +2. Abre la misma URL en una ventana privada del mismo navegador. +3. Confirma que tu conexión puede abrir otras páginas y que una VPN, proxy o filtro corporativo no esté bloqueando Hellotext. +4. Prueba otro navegador actualizado o una red distinta cuando la política de tu equipo lo permita. +5. Cierra sesión y vuelve a ingresar si el problema parece limitado a tu sesión. +6. Deshabilita temporalmente extensiones de privacidad o bloqueo de contenido para probar, cuando sea seguro hacerlo. + +Limpia los datos del sitio solo después de guardar la evidencia y cualquier trabajo sin guardar. Este paso cierra la sesión y borra preferencias locales del navegador, aunque no elimina información guardada en tu negocio de Hellotext. + +## Revisa permisos y contexto + +Si la navegación general funciona, pero una página específica no: + +- confirma que estás en el negocio correcto; +- revisa si tu rol permite acceder a esa configuración o reporte; +- abre la página desde la navegación de Hellotext en vez de usar un favorito antiguo; +- elimina filtros para comprobar si la vista vuelve a mostrar datos; y +- revisa si el objeto enlazado todavía existe y sigue disponible para tu negocio. + +Un error de acceso, una vista sin datos y una carga técnica fallida necesitan soluciones distintas. Conserva el texto exacto del aviso. + +## Obtén evidencia técnica + +Si tienes acceso a las herramientas de desarrollo del navegador: + +1. Abre **Consola** y **Red** antes de reproducir el problema. +2. Recarga la página y repite la acción una vez. +3. Conserva el texto del primer error relevante. +4. En **Red**, identifica solicitudes fallidas y anota URL, método, estado y hora. + +Un archivo HAR puede contener identificadores de clientes, contenido de mensajes, cookies o encabezados de autorización. No lo compartas salvo que soporte lo solicite y hayas confirmado una forma segura de enviarlo. + +## Cuándo contactar a soporte + +Contacta a soporte cuando: + +- el problema también ocurre en una ventana privada y otro navegador o red; +- afecta a varias personas o negocios; +- impide acceder a Inbox, canales, campañas, playbooks, facturación o datos esenciales; +- una acción queda en un estado incierto y repetirla podría duplicar resultados; o +- ves errores repetidos de servidor o solicitudes fallidas que no puedes resolver. + +Usa [Contacta a soporte de Hellotext]({% link _troubleshooting-deliverability/contact-hellotext-support.md %}) para reunir la información necesaria. + +## Guías relacionadas + +- [Checklist de solución de problemas]({% link _troubleshooting-deliverability/troubleshooting-checklist.md %}) +- [Soluciona señales o actividad faltante]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}) +- [Soluciona una captura que no aparece o no registra clientes]({% link _troubleshooting-deliverability/troubleshoot-a-capture.md %}) +- [Diferencias e integridad de datos en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/es/troubleshooting-deliverability/troubleshoot-whatsapp-templates.md b/_i18n/es/troubleshooting-deliverability/troubleshoot-whatsapp-templates.md new file mode 100644 index 00000000..9462db58 --- /dev/null +++ b/_i18n/es/troubleshooting-deliverability/troubleshoot-whatsapp-templates.md @@ -0,0 +1,139 @@ +Usa esta guía cuando una campaña, ruta, playbook o respuesta no puede enviar por WhatsApp porque la plantilla está en revisión, fue rechazada, perdió calidad o ya no está disponible en Meta. + +Las plantillas permiten iniciar mensajes de WhatsApp fuera de la ventana de atención de 24 horas. Hellotext prepara y sincroniza el contenido, pero Meta controla la aprobación, categoría, calidad y disponibilidad final de cada plantilla. + +## Primero identifica el estado + +Abre la campaña, ruta o plantilla afectada y revisa el estado de WhatsApp. También puedes ir a **Ajustes → Plantillas** para encontrarla y revisar su historial de cambios. + +Los estados más importantes son: + +- **Meta en revisión:** Meta todavía no tomó una decisión sobre esa versión. +- **Activo o aprobado:** la versión puede usarse para enviar. +- **Rechazado por Meta:** esa versión no puede usarse hasta corregirla y volver a enviarla. +- **Marcado por Meta:** la calidad bajó y la plantilla corre riesgo de ser pausada o deshabilitada. +- **Pausado por Meta:** la plantilla no puede usarse temporalmente. +- **Deshabilitado:** Meta dejó de permitir el uso de esa plantilla. +- **Requiere tu atención:** una plantilla importada contiene parámetros que Hellotext no pudo convertir en propiedades del cliente. + +No confundas el estado de la campaña con el de la plantilla. Una campaña puede estar programada pero seguir esperando la aprobación de su contenido de WhatsApp. + +## La plantilla está en revisión + +Meta revisa las plantillas nuevas y algunos cambios. El tiempo de aprobación puede variar, por lo que no programes una campaña importante sin dejar margen para la revisión. + +Mientras una edición está pendiente: + +- si ya existe una versión aprobada, los mensajes pueden seguir usando esa versión activa; +- si la plantilla es nueva y no tiene una versión aprobada, los mensajes que la necesitan deben esperar; y +- la nueva versión se activa automáticamente cuando Meta la aprueba. + +No hagas cambios repetidos mientras Meta revisa la misma versión. Revisa primero la vista previa, la categoría, los links, botones y ejemplos, y agrupa las correcciones antes de volver a enviar. + +## La plantilla fue rechazada + +Abre la plantilla y revisa el comentario de WhatsApp. Corrige el motivo señalado antes de guardarla otra vez para aprobación. + +Comprueba especialmente que: + +- el mensaje tenga un propósito claro y coincida con su categoría; +- el contenido no pueda interpretarse como abusivo, engañoso o una estafa; +- una plantilla de utilidad describa una interacción o actualización esperada y no esconda una promoción; +- el texto no comience ni termine con una etiqueta de personalización; +- las propiedades y ejemplos produzcan una frase completa y comprensible; +- los links y botones coincidan con lo que promete el mensaje; y +- el negocio y la razón del contacto sean reconocibles para el cliente. + +Una plantilla de WhatsApp existente no puede cambiar de nombre. Si necesitas otro nombre o un propósito sustancialmente diferente, crea una plantilla nueva. + +Guardar la corrección vuelve a enviarla a Meta. No programes el envío hasta que la nueva versión figure como aprobada. + +## Meta cambió la categoría + +Meta puede reclasificar una plantilla cuando considera que el contenido corresponde a otra categoría. Esto puede cambiar cómo se usa y cobra el mensaje. + +Revisa el aviso de Hellotext. Puedes: + +- editar el contenido para que coincida claramente con la categoría deseada y volver a enviarlo; o +- apelar el cambio desde Meta cuando consideres que la clasificación es incorrecta. + +La categoría de una plantilla ya aprobada no se cambia directamente desde Hellotext. Cuando necesitas otra categoría, normalmente debes crear una plantilla nueva o seguir el proceso de apelación indicado por Meta. + +## La plantilla está marcada o perdió calidad + +Meta evalúa señales como bloqueos, reportes y tasas de lectura. Una plantilla marcada puede seguir disponible, pero corre riesgo de pausa o deshabilitación. + +Antes de volver a usarla ampliamente: + +- confirma que la audiencia espere ese mensaje; +- reduce envíos repetitivos o poco relevantes; +- deja claro quién escribe y por qué; +- revisa que la frecuencia y el momento tengan sentido; y +- usa una segmentación más específica cuando el contenido no aplica a todos. + +Cambiar unas pocas palabras no corrige una audiencia incorrecta. Revisa juntos el contenido, el consentimiento y el motivo del envío. + +## La plantilla está pausada o deshabilitada + +Una plantilla pausada o deshabilitada no debe seguir usándose para nuevos envíos. + +- Si está **pausada**, revisa la calidad y espera la recuperación indicada por Meta antes de reactivarla. +- Si está **deshabilitada**, usa otra plantilla aprobada o crea una nueva versión adecuada. +- Si un mensaje ya falló por este motivo y Hellotext ofrece otro canal elegible, puedes elegirlo cuando el contenido y el consentimiento sean compatibles. + +No reintentes repetidamente la misma plantilla mientras conserve ese estado. El reintento no cambia la decisión de Meta. + +## La plantilla fue eliminada o no aparece en Meta + +Una plantilla puede existir en Hellotext pero haber sido eliminada o dejar de estar disponible en la cuenta de WhatsApp conectada. + +Confirma que: + +- el negocio siga conectado a la cuenta de WhatsApp correcta; +- el número y la cuenta de WhatsApp Business sigan activos; +- la plantilla exista en Meta para ese número, idioma y nombre; y +- no haya sido eliminada por otro usuario o integración. + +Cuando Hellotext indique que Meta ya no tiene la plantilla aprobada, confirma si fue eliminada antes de volver a enviarla. Si la plantilla aprobada fue eliminada, selecciona otra plantilla activa, crea una nueva con otro nombre o espera 30 días antes de reutilizar el nombre eliminado. De lo contrario, guarda los cambios para volver a enviarla a aprobación. + +## Los parámetros importados necesitan atención + +Una plantilla importada desde WhatsApp puede contener variables que Hellotext no puede asociar automáticamente con propiedades del cliente. + +Edita la plantilla y reemplaza cada parámetro por una propiedad compatible o por contenido fijo. Usa la vista previa para confirmar que todos los valores tengan un resultado comprensible antes de guardar. + +Los cambios en la forma de completar variables dentro de Hellotext no siempre requieren una nueva revisión de Meta cuando el contenido aprobado de la plantilla no cambia. El estado mostrado en Hellotext indica si esa versión volvió a revisión. + +## Una campaña sigue esperando + +Si la campaña usa WhatsApp: + +1. Abre la campaña y confirma si está **En revisión**, **WhatsApp en revisión**, **Programada** o rechazada. +2. Abre la plantilla asociada y revisa su estado y feedback. +3. Corrige el contenido únicamente si fue rechazado o requiere atención. +4. Confirma que la fecha programada todavía sea válida después de la aprobación. +5. Envía una prueba cuando la plantilla esté activa. + +Una prueba de WhatsApp con contenido nuevo también puede esperar hasta que Meta apruebe la plantilla. La prueba no evita la revisión. + +## Qué incluir al pedir ayuda + +Incluye: + +- negocio y número de WhatsApp afectados; +- nombre y link de la plantilla; +- campaña, ruta o playbook que intenta usarla; +- idioma y categoría; +- estado y comentario exactos de Meta; +- momento del último cambio; y +- captura de la vista previa y del aviso. + +No incluyas tokens, contraseñas ni información de pago de Meta. + +## Guías relacionadas + +- [Fundamentos del canal de WhatsApp]({% link _numbers/whatsapp-channel-fundamentals.md %}) +- [Conecta WhatsApp]({% link _integrations/connect-whatsapp.md %}) +- [Crear una campaña]({% link _campaigns/creating-a-campaign.md %}) +- [Por qué no se envió un mensaje]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}) +- [A quién puedes enviar mensajes]({% link _audience/consent-and-subscriber-status.md %}) diff --git a/_i18n/es/troubleshooting-deliverability/troubleshooting-checklist.md b/_i18n/es/troubleshooting-deliverability/troubleshooting-checklist.md index 4214c4e4..7baaf16d 100644 --- a/_i18n/es/troubleshooting-deliverability/troubleshooting-checklist.md +++ b/_i18n/es/troubleshooting-deliverability/troubleshooting-checklist.md @@ -4,7 +4,7 @@ Antes de cambiar configuración, anota el síntoma exacto, el negocio afectado, ## 1. Confirma la configuración y los datos de origen -Si faltan perfiles de cliente, productos, órdenes o configuración de canales, o si la información parece desactualizada, empieza por la configuración. +Si faltan perfiles de clientes, productos, pedidos o configuración de canales, o si la información parece desactualizada, empieza por la configuración. Revisa si la tienda o integración está conectada, si los datos recientes se están sincronizando y si el perfil del cliente afectado tiene los datos esperados. @@ -21,6 +21,8 @@ Revisa el remitente, el consentimiento para ese canal, el acceso de la cuenta, s Sigue leyendo: +- [Por qué no se envió un mensaje]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}) +- [Soluciona problemas con plantillas de WhatsApp]({% link _troubleshooting-deliverability/troubleshoot-whatsapp-templates.md %}) - [Resumen de canales de mensajería]({% link _numbers/messaging-overview.md %}) - [Límites de envío SMS para negocios nuevos]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}) - [Conecta WhatsApp]({% link _integrations/connect-whatsapp.md %}) @@ -64,4 +66,6 @@ Sigue leyendo: ## Cuando contactes a soporte -Incluye el nombre del negocio, el perfil del cliente afectado, el canal, el link a la campaña, playbook, conversación o reporte, la hora aproximada, qué esperabas, qué ocurrió y cualquier captura o cambio reciente de configuración. +Si una página no carga, conserva la URL, el momento del error y la última acción antes de recargar. Sigue [Soluciona páginas que no cargan]({% link _troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md %}). + +Incluye el nombre del negocio, el perfil del cliente afectado, el canal, el link a la campaña, playbook, conversación o reporte, la hora aproximada, qué esperabas, qué ocurrió y cualquier captura o cambio reciente de configuración. Revisa [Contacta a soporte de Hellotext]({% link _troubleshooting-deliverability/contact-hellotext-support.md %}) antes de enviar información sensible. diff --git a/_i18n/es/troubleshooting-deliverability/troubleshooting-overview.md b/_i18n/es/troubleshooting-deliverability/troubleshooting-overview.md index 792a8960..40e97b91 100644 --- a/_i18n/es/troubleshooting-deliverability/troubleshooting-overview.md +++ b/_i18n/es/troubleshooting-deliverability/troubleshooting-overview.md @@ -1,17 +1,19 @@ Usa esta sección cuando algo en Hellotext no se ve bien y necesitas definir dónde revisar primero. -La solución de problemas normalmente empieza en uno de cuatro lugares: +La solución de problemas normalmente empieza en uno de estos lugares: - Configuración e integraciones. - Canales y entrega de mensajes. - Tracking, reportes y atribución. - Operación del inbox y flujos del equipo. +- Capturas y experiencias del sitio. +- Acceso y carga de páginas. Si no estás seguro de dónde pertenece el problema, empieza por el [checklist de solución de problemas]({% link _troubleshooting-deliverability/troubleshooting-checklist.md %}). ## Configuración e integraciones -Si faltan perfiles de cliente, productos, órdenes o configuración de canales, o si la información parece desactualizada, empieza revisando el camino de integración y configuración. +Si faltan perfiles de clientes, productos, pedidos o configuración de canales, o si la información parece desactualizada, empieza revisando el camino de integración y configuración. Sigue leyendo: [Resumen de configuración e integraciones]({% link _integrations/setup-overview.md %}). @@ -19,8 +21,12 @@ Sigue leyendo: [Resumen de configuración e integraciones]({% link _integrations Si un mensaje no se entrega, primero revisa el canal usado, la configuración del remitente, consentimiento, saldo o acceso del plan, y cualquier límite temporal de envío. +Empieza aquí: [Por qué no se envió un mensaje]({% link _troubleshooting-deliverability/why-a-message-did-not-send.md %}). + Para límites específicos de SMS en negocios prepago nuevos, sigue leyendo: [Límites de envío SMS para negocios nuevos]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}). +Si el problema es una plantilla de WhatsApp en revisión, rechazada, marcada o pausada, usa [Soluciona problemas con plantillas de WhatsApp]({% link _troubleshooting-deliverability/troubleshoot-whatsapp-templates.md %}). + Para contexto de configuración de canales, sigue leyendo: [Resumen de canales de mensajería]({% link _numbers/messaging-overview.md %}). ## Campañas @@ -44,3 +50,17 @@ Si el problema es específico de un playbook, usa [Soluciona un playbook que no Si las conversaciones no las está gestionando la persona correcta, o si la performance de respuesta parece incorrecta, revisa asignación, roles, ownership y configuración de tiempos de respuesta. Sigue leyendo: [Resumen de inbox y conversaciones]({% link _team/inbox-overview.md %}). + +## Capturas y experiencias del sitio + +Si un popup, formulario, Webchat, código QR, link u opt-in de checkout no aparece o no registra al cliente, identifica primero si el problema está en la disponibilidad, instalación, interacción, verificación, perfil del cliente o acción posterior. + +Empieza aquí: [Soluciona una captura que no aparece o no registra clientes]({% link _troubleshooting-deliverability/troubleshoot-a-capture.md %}). + +## Acceso y carga de páginas + +Si una página queda vacía, no termina de cargar o muestra el mismo error, conserva la URL y el momento del problema antes de recargar. + +Empieza aquí: [Soluciona páginas que no cargan]({% link _troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md %}). + +Si el problema continúa, consulta [Contacta a soporte de Hellotext]({% link _troubleshooting-deliverability/contact-hellotext-support.md %}). diff --git a/_i18n/es/troubleshooting-deliverability/why-a-message-did-not-send.md b/_i18n/es/troubleshooting-deliverability/why-a-message-did-not-send.md new file mode 100644 index 00000000..ad17823c --- /dev/null +++ b/_i18n/es/troubleshooting-deliverability/why-a-message-did-not-send.md @@ -0,0 +1,156 @@ +Usa esta guía cuando esperabas un mensaje de una campaña, playbook, ruta, conversación o integración, pero no se envió o no llegó al cliente. + +Empieza por encontrar el mensaje o la actividad que debía crearlo. El siguiente paso depende de si el mensaje nunca existió, todavía se está procesando o terminó con un error de entrega. + +## Primero identifica qué ocurrió + +### El mensaje nunca se creó + +Si no encuentras ningún mensaje, todavía no estás ante un fallo de entrega. Revisa el origen: + +- **Campaña:** confirma que no siga como borrador, en revisión o programada, y que el perfil del cliente fuera elegible para la audiencia y los canales elegidos. +- **Playbook:** confirma que se haya disparado, que la oportunidad siga siendo válida y que Hellotext haya decidido enviar en ese momento. +- **Ruta:** revisa el disparador, las condiciones, esperas, ramas y el paso que debía enviar. +- **Inbox:** confirma que la respuesta se haya enviado y no haya quedado como nota interna o borrador. +- **API:** confirma que la solicitud haya sido aceptada y luego revisa el estado real del mensaje. Una respuesta `status: received` confirma recepción de la solicitud, no entrega al cliente. + +Para automatizaciones, consulta [Soluciona un playbook que no se disparó o no envió]({% link _journeys/troubleshoot-a-playbook-that-did-not-trigger-or-send.md %}). Si falta la actividad que debía iniciar el flujo, usa [Soluciona señales o actividad faltante]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}). + +### El mensaje está pendiente o enrutado + +Un mensaje puede estar creado pero todavía no tener confirmación final: + +- `pending` indica que espera procesamiento; +- `routed` indica que se envió al proveedor externo; y +- `delivered` indica que el proveedor confirmó la entrega. + +Revisa la hora del mensaje y espera un tiempo razonable antes de reintentar. Una demora del proveedor no siempre termina en fallo, y crear otro mensaje demasiado pronto puede producir un duplicado. + +### El mensaje aparece como no enviado + +Abre el mensaje dentro de la conversación y lee el motivo mostrado junto a **No enviado**. Hellotext normaliza la respuesta del canal para explicar qué impidió la entrega y, cuando corresponde, puede ofrecer **Reintentar**, **Elegir canal** o una acción para corregir la cuenta. + +El motivo exacto es más útil que el estado general. Anótalo antes de cambiar configuración. + +## Consentimiento y datos del cliente + +No reintentes un mensaje cuando el perfil del cliente está desuscrito. La baja debe respetarse en todos los envíos que dependan de ese consentimiento. + +También revisa que el perfil del cliente tenga una identidad válida para el canal: + +- teléfono completo y correcto para SMS o WhatsApp; +- cuenta alcanzable en el canal correspondiente; y +- estado de bloqueo y suscripción compatible con el mensaje. + +Si el cliente tiene otro canal disponible, Hellotext puede permitir elegirlo para un nuevo intento. Un canal alternativo no evita las reglas de consentimiento que le correspondan. + +Consulta [A quién puedes enviar mensajes]({% link _audience/consent-and-subscriber-status.md %}) para diferenciar identidad, verificación, alcance y suscripción. + +## Facturación y límites de la cuenta + +El mensaje puede quedar bloqueado cuando el negocio necesita: + +- agregar o actualizar un método de pago; +- agregar saldo o activar la recarga automática; +- aumentar un límite de recarga; o +- resolver un límite diario o mensual de mensajes. + +Corrige la condición indicada antes de reintentar. Si el motivo es un límite temporal diario, espera hasta que el envío vuelva a estar permitido. Para cuentas SMS nuevas, revisa [Límites de envío SMS para negocios nuevos]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}). + +## Problemas del canal o remitente + +Confirma que el canal siga conectado y activo, que el remitente seleccionado pertenezca al negocio y que la integración conserve los permisos necesarios. + +Una configuración que funcionaba antes puede dejar de hacerlo si se desconecta una cuenta, cambia un permiso, Meta restringe un número o el proveedor deja temporalmente de estar disponible. + +No cambies el contenido ni la automatización hasta confirmar si el motivo pertenece al canal. Revisa [Resumen de canales de mensajería]({% link _numbers/messaging-overview.md %}) para volver a la configuración correspondiente. + +## Motivos de WhatsApp + +Los motivos más comunes incluyen: + +- **Ventana de 24 horas cerrada:** un mensaje libre ya no puede enviarse. Usa una plantilla aprobada o un canal alternativo disponible. +- **Número no alcanzable:** Meta no pudo entregar al número del cliente. +- **Marketing limitado u opt-out:** Meta limitó el mensaje de marketing o el cliente indicó que no quiere recibirlo. +- **Plantilla pausada o deshabilitada:** usa otra plantilla aprobada o corrige su estado en Meta. +- **Nombre para mostrar pendiente:** Meta debe aprobar el nombre antes de habilitar envíos. +- **Permisos, registro, políticas o pago:** revisa la cuenta y el número dentro de Meta. +- **Límite de envíos o servicio temporalmente no disponible:** espera antes de reintentar. +- **Experimento activo:** Meta puede excluir ese mensaje de una prueba de entrega. Si Hellotext ofrece otro canal elegible, puedes usarlo. + +No repitas inmediatamente un envío limitado por Meta. Primero corrige la condición o espera el período indicado. Para contenido todavía en revisión o rechazado, revisa el estado de la plantilla antes de volver a programar la campaña. + +## Motivos de SMS + +Un SMS puede aparecer como no entregado cuando: + +- el operador informó que no llegó al destinatario; +- el proveedor canceló el envío; +- el número es inválido o no está disponible; o +- ocurrió un problema temporal del proveedor. + +Comprueba el formato internacional del número y evita insistir sobre destinos que el operador marcó como no alcanzables. Si el problema fue temporal y Hellotext muestra **Reintentar**, espera unos minutos y vuelve a intentarlo una sola vez. + +## Motivos de Mercado Libre + +Mercado Libre puede impedir el envío por: + +- el horario o los límites de conversaciones iniciadas por el vendedor; +- el estado del pago o fulfillment; +- un bloqueo del comprador; +- una mediación activa; o +- restricciones de una tienda invitada. + +Estos motivos dependen del estado de la operación o conversación en Mercado Libre. Corrige o espera ese estado antes de reintentar; cambiar el texto no elimina la restricción. + +## El mensaje ya no era relevante + +Algunos mensajes de playbooks se cancelan intencionalmente antes de salir porque la oportunidad cambió. Por ejemplo: + +- el cliente ya completó el carrito o compró el producto; +- el producto está agotado o dejó de estar disponible; +- falta la URL de checkout; +- un cambio de precio más reciente reemplazó al anterior; o +- el pedido que originó un recordatorio fue cancelado o reembolsado. + +En estos casos no reintentes el mensaje. La cancelación evita comunicar información vencida o insistir después de que el cliente ya convirtió. + +## Decide si debes reintentar + +Reintenta solamente cuando: + +- el motivo era temporal; +- corregiste la configuración, el pago o los permisos; y +- Hellotext muestra una opción válida para reintentar o elegir otro canal. + +No reintentes cuando: + +- el cliente está desuscrito o bloqueó mensajes; +- el destino es definitivamente no alcanzable; +- el mensaje ya no aplica por una compra, cancelación o cambio de producto; o +- la plataforma prohíbe ese tipo de mensaje en la conversación actual. + +Después de reintentar, confirma que el nuevo mensaje llegue a `delivered`. No uses varios reintentos seguidos para resolver una causa que todavía sigue activa. + +## Qué incluir al pedir ayuda + +Si el motivo no alcanza para resolver el problema, incluye: + +- nombre del negocio; +- link al perfil del cliente y a la conversación; +- campaña, playbook, ruta o integración de origen; +- canal y remitente; +- fecha, hora y zona horaria; +- motivo exacto mostrado en **No enviado**; +- resultado de cualquier reintento; y +- captura de pantalla y cambios recientes de configuración. + +No incluyas tokens de API, contraseñas ni datos completos de pago. + +## Guías relacionadas + +- [Checklist de solución de problemas]({% link _troubleshooting-deliverability/troubleshooting-checklist.md %}) +- [Soluciona un playbook que no se disparó o no envió]({% link _journeys/troubleshoot-a-playbook-that-did-not-trigger-or-send.md %}) +- [Cómo decide Hellotext si un playbook puede enviar]({% link _journeys/how-hellotext-decides-whether-a-playbook-can-send.md %}) +- [Crear una campaña]({% link _campaigns/creating-a-campaign.md %}) +- [Enviar SMS con la API]({% link _developers/send-sms-with-api.md %}) diff --git a/_troubleshooting-deliverability/contact-hellotext-support.md b/_troubleshooting-deliverability/contact-hellotext-support.md new file mode 100644 index 00000000..ffeec3c5 --- /dev/null +++ b/_troubleshooting-deliverability/contact-hellotext-support.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Contact Hellotext Support + description: Send the context Support needs to identify, reproduce, and resolve a Hellotext problem. +es: + title: Contacta a soporte de Hellotext + description: Envía el contexto que soporte necesita para identificar, reproducir y resolver un problema en Hellotext. + +permalink: contact-hellotext-support +permalink_es: contactar-soporte-hellotext + +layout: guide +topic: troubleshooting-deliverability +popular: false +--- + +{% translate_file troubleshooting-deliverability/contact-hellotext-support.md %} diff --git a/_troubleshooting-deliverability/troubleshoot-a-capture.md b/_troubleshooting-deliverability/troubleshoot-a-capture.md new file mode 100644 index 00000000..7efaab9b --- /dev/null +++ b/_troubleshooting-deliverability/troubleshoot-a-capture.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Troubleshoot a capture that does not appear or register customers + description: Find where a popup, form, Webchat, QR code, link, or checkout capture stopped working. +es: + title: Soluciona una captura que no aparece o no registra clientes + description: Encuentra dónde dejó de funcionar un popup, formulario, Webchat, código QR, link o captura de checkout. + +permalink: troubleshoot-a-capture +permalink_es: solucionar-una-captura + +layout: guide +topic: troubleshooting-deliverability +popular: false +--- + +{% translate_file troubleshooting-deliverability/troubleshoot-a-capture.md %} diff --git a/_troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md b/_troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md new file mode 100644 index 00000000..3ce2833f --- /dev/null +++ b/_troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Troubleshoot pages that do not load + description: Diagnose blank, incomplete, slow, or repeatedly failing pages in Hellotext without losing useful evidence. +es: + title: Soluciona páginas que no cargan + description: Diagnostica páginas de Hellotext vacías, incompletas, lentas o con errores repetidos sin perder evidencia útil. + +permalink: troubleshoot-pages-that-do-not-load +permalink_es: solucionar-paginas-que-no-cargan + +layout: guide +topic: troubleshooting-deliverability +popular: false +--- + +{% translate_file troubleshooting-deliverability/troubleshoot-pages-that-do-not-load.md %} diff --git a/_troubleshooting-deliverability/troubleshoot-whatsapp-templates.md b/_troubleshooting-deliverability/troubleshoot-whatsapp-templates.md new file mode 100644 index 00000000..b8a6a3a3 --- /dev/null +++ b/_troubleshooting-deliverability/troubleshoot-whatsapp-templates.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Troubleshoot WhatsApp templates + description: Resolve templates that are under review, rejected, flagged, paused, disabled, or missing in Meta. +es: + title: Soluciona problemas con plantillas de WhatsApp + description: Resuelve plantillas en revisión, rechazadas, marcadas, pausadas, deshabilitadas o ausentes en Meta. + +permalink: troubleshoot-whatsapp-templates +permalink_es: solucionar-plantillas-whatsapp + +layout: guide +topic: troubleshooting-deliverability +popular: true +--- + +{% translate_file troubleshooting-deliverability/troubleshoot-whatsapp-templates.md %} diff --git a/_troubleshooting-deliverability/why-a-message-did-not-send.md b/_troubleshooting-deliverability/why-a-message-did-not-send.md new file mode 100644 index 00000000..95028ee6 --- /dev/null +++ b/_troubleshooting-deliverability/why-a-message-did-not-send.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Why a message did not send + description: Identify whether a message was never created, is still processing, or failed, then resolve the reason without sending duplicates. +es: + title: Por qué no se envió un mensaje + description: Identifica si el mensaje no se creó, todavía se está procesando o falló, y resuelve el motivo sin generar duplicados. + +permalink: why-a-message-did-not-send +permalink_es: por-que-no-se-envio-un-mensaje + +layout: guide +topic: troubleshooting-deliverability +popular: true +--- + +{% translate_file troubleshooting-deliverability/why-a-message-did-not-send.md %}