For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/faq/messaging/message-failed-in-chat.md.
  • English

      • My message failed in the chat. How do I find out why?

      When a message is not delivered, a red icon appears next to its timestamp. Hover over that icon: the tooltip shows the cause of the failure, what to do, and the code WhatsApp returned.

      1. Open the conversation and find the message with the red icon.
      2. Hover over the icon and read the first line — that is the cause.
      3. The second line, when present, is the recommended action. Follow it before resending.
      4. If the message mentions the number's connection, also check the notification bell at the top of the chat: it lists the active problems on your WhatsApp account under Issue detected with your WhatsApp account.

      Two similar failures, different actions

      WhatsApp uses the same code for different causes, so the difference is in the wording:

      The tooltip saysWhat happenedWhat to do
      "Meta rejected the send because the message had an invalid or missing field"That message's content was rejected; the number is still healthyResend. If it keeps happening, contact support
      "Meta no longer recognizes this number for sending"The number's connection dropped, or its setup was never completedReconnect WhatsApp — resending will not help

      Until the second case is resolved, no message from that number is delivered, neither in the chat nor in automations.

      When the message never left

      Not every failure comes from WhatsApp. Some happen earlier, in your browser, and the tooltip says so in different words:

      The tooltip saysWhat happenedWhat to do
      "We could not prepare this file for WhatsApp here in the browser"The file has to be converted before it can be sent, and the conversion did not finishRefresh the page and send it again
      "This file format cannot be sent on WhatsApp"WhatsApp does not accept this file typeConvert it to a supported format
      "We could not complete the send from your browser"The send never reached ClickmaxCheck your connection and click Try again

      In these cases the message does not exist on the other side: nobody received anything, not even partially. Try again resends the same content, with no need to type or record it again.

      The button next to the failure depends on the cause

      When a text message left and WhatsApp returned the failure, the bubble shows the action that fits that cause:

      Cause of the failureWhat the bubble showsWhat happens
      Temporary WhatsApp instabilityTry againSends a new message with the same text. The original stays in the conversation, without the button
      24-hour window expiredSend templateOpens the template picker — outside the window, only an approved template can be sent
      A failure that resending does not fixNo buttonOnly the red icon notice remains, with the cause and what to do

      If the previous attempt is still in progress, Clickmax asks you to wait before resending. A message can only be resent once: after the resend, the status is tracked on the new message.

      You saw "New version available"

      If you keep the Service tab open for several days, parts of the app may stop loading after an update — and often the first sign is a send that fails. When that happens, a New version available notice appears with a Refresh button.

      Click Refresh. Failed sends stay in the conversation, ready to be resent.

      If it did not work

      • The tooltip asks you to reconnect, but the number looks connected: the setup on Meta may be incomplete — check the pending items in the notification bell and finish connecting WhatsApp.
      • The failure is on a template, not a chat message: see templates with "Send failed".
      • Other messaging questions: see the FAQ.