{"id":3226,"date":"2022-05-22T07:43:47","date_gmt":"2022-05-22T07:43:47","guid":{"rendered":"https:\/\/blog.ultramsg.com\/whatsapp-api-message-and-queue-management\/"},"modified":"2025-12-11T13:21:27","modified_gmt":"2025-12-11T09:21:27","slug":"whatsapp-api-message-and-queue-management","status":"publish","type":"post","link":"https:\/\/blog.ultramsg.com\/pt-br\/whatsapp-api-message-and-queue-management\/","title":{"rendered":"Gerenciamento de mensagens e filas"},"content":{"rendered":"\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Seu cliente v\u00ea uma mensagem no aplicativo WhatsApp, mas n\u00e3o sabe que ela cruzou mais de 100 servidores e roteadores ao redor do mundo.<\/strong><\/p>\n<cite><strong>Ultramsg<\/strong> ! n\u00e3o apenas uma mensagem <\/cite><\/blockquote>\n\n<h2 class=\"wp-block-heading\">Estados de mensagem na inst\u00e2ncia <\/h2>\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"148\" src=\"https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-5-1024x148.png\" alt=\"\" class=\"wp-image-3075\" style=\"width:690px;height:99px\" title=\"\" srcset=\"https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-5-1024x148.png 1024w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-5-300x43.png 300w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-5-768x111.png 768w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-5.png 1284w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\"><strong>Voc\u00ea pode clicar no bot\u00e3o Reenviar, para reenviar todas as mensagens que n\u00e3o foram enviadas.<\/strong><\/figcaption><\/figure><\/div>\n<ul class=\"wp-block-list\">\n<li><strong>Enviadas<\/strong> : Mensagens enviadas com sucesso.<\/li>\n\n\n\n<li><strong>Fila<\/strong> : As mensagens est\u00e3o na fila e as mensagens ser\u00e3o enviadas com base na prioridade.<\/li>\n\n\n\n<li>N\u00e3o <strong>enviadas<\/strong> : Mensagens que n\u00e3o foram enviadas por motivos t\u00e9cnicos e, na maioria dos casos, \u00e9 devido a um erro no conte\u00fado da mensagem.<\/li>\n\n\n\n<li><strong>Inv\u00e1lido<\/strong> : Mensagens n\u00e3o enviadas, pois o n\u00famero est\u00e1 errado ou n\u00e3o tem WhatsApp.<\/li>\n\n\n\n<li><strong>Expirado<\/strong> : todas as mensagens n\u00e3o enviadas da fila dentro de 24 horas por qualquer motivo expiram.<\/li>\n<\/ul>\n\n<h2 class=\"wp-block-heading\">Reenviar mensagens que n\u00e3o foram enviadas usando a API <\/h2>\n\n<pre class=\"wp-block-code\"><code><a href=\"https:\/\/docs.ultramsg.com\/api\/post\/messages\/resendByStatus\" target=\"_blank\" rel=\"noreferrer noopener\">\/resendByStatus<\/a><\/code><\/pre>\n\n<p>Este m\u00e9todo pode ser usado para reenviar mensagens com falha por status de mensagem.<\/p>\n\n<pre class=\"wp-block-code\"><code><a href=\"https:\/\/docs.ultramsg.com\/api\/post\/messages\/resendById\" target=\"_blank\" data-type=\"URL\" data-id=\"https:\/\/docs.ultramsg.com\/api\/post\/messages\/resendById\" rel=\"noreferrer noopener\">\/resendById<\/a><\/code><\/pre>\n\n<p>Este m\u00e9todo pode ser usado para reenviar mensagens com falha por ID de mensagem.<\/p>\n\n<h2 class=\"wp-block-heading\">O n\u00famero de segundos entre as mensagens <\/h2>\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"800\" height=\"341\" src=\"https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/Send_Delay_max.gif\" alt=\"\" class=\"wp-image-5851\" title=\"\"><figcaption class=\"wp-element-caption\">O intervalo de tempo em segundos entre as mensagens<\/figcaption><\/figure><\/div><div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"572\" src=\"https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/Send-Delay-1024x572.jpg\" alt=\"\" class=\"wp-image-5883\" title=\"\" srcset=\"https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/Send-Delay-1024x572.jpg 1024w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/Send-Delay-300x167.jpg 300w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/Send-Delay-768x429.jpg 768w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/Send-Delay-1536x857.jpg 1536w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/Send-Delay-2048x1143.jpg 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure><\/div>\n<p><\/p>\n\n<p><strong><mark style=\"background-color:rgba(0, 0, 0, 0);color:#14deae\" class=\"has-inline-color\">Atraso de envio<\/mark><\/strong>: Aplica-se quando a fila tem menos de 10 mensagens. O valor padr\u00e3o \u00e9 1 segundo, e \u00e9 recomend\u00e1vel aument\u00e1-lo para 5 segundos, exceto se a sua empresa usar um chatbot.<\/p>\n\n<p><strong><mark style=\"background-color:rgba(0, 0, 0, 0);color:#14deae\" class=\"has-inline-color\">M\u00e1ximo de atraso de envio<\/mark><\/strong>: Aplica-se automaticamente quando a fila atinge 10 mensagens ou mais. O valor padr\u00e3o \u00e9 15 segundos, e \u00e9 recomend\u00e1vel aument\u00e1-lo com base nas necessidades do seu projeto, como 20 a 25 segundos.<\/p>\n\n<h2 class=\"wp-block-heading\">Gerenciamento de filas usando prioridade de mensagem <\/h2>\n\n<p><\/p>\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"489\" src=\"https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-6-1024x489.png\" alt=\"\" class=\"wp-image-3092\" title=\"\" srcset=\"https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-6-1024x489.png 1024w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-6-300x143.png 300w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-6-768x367.png 768w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-6-1536x733.png 1536w, https:\/\/blog.ultramsg.com\/wp-content\/uploads\/2022\/05\/image-6.png 1580w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n<p>Este par\u00e2metro \u00e9 opcional, voc\u00ea pode us\u00e1-lo para criar uma fila profissional para mensagens, As mensagens com menor valor de prioridade s\u00e3o enviadas primeiro.<\/p>\n\n<p><strong>exemplo de uso:<\/strong><\/p>\n\n<p>prioridade = 0: para alta prioridade como mensagens OTP.<\/p>\n\n<p>prioridade = 5: usado com mensagens gerais.<\/p>\n\n<p>prioridade =10: ofertas promocionais n\u00e3o urgentes e notifica\u00e7\u00f5es para seus clientes.<\/p>\n\n<p>Valor padr\u00e3o: 10<\/p>\n\n<p><strong>Exemplo de gerenciamento de filas:<\/strong><\/p>\n\n<p>Voc\u00ea enviou 100 mensagens promocionais para seus clientes com prioridade 10.<br\/>Em seguida, voc\u00ea enviou 1 mensagem do WhatsApp como um c\u00f3digo de ativa\u00e7\u00e3o com prioridade 10.<br\/>Agora, uma mensagem de c\u00f3digo de ativa\u00e7\u00e3o ser\u00e1 enviada ap\u00f3s o envio das 100 mensagens promocionais.<\/p>\n\n<p>Mas se voc\u00ea enviar 1 mensagem do WhatsApp como c\u00f3digo de ativa\u00e7\u00e3o com uma prioridade menor que 10, por exemplo, 9<br\/>A mensagem de ativa\u00e7\u00e3o ser\u00e1 enviada primeiro&#8230; e depois o restante das mensagens ser\u00e1 enviado.<\/p>\n\n<h2 class=\"wp-block-heading\">Excluir mensagens da inst\u00e2ncia <\/h2>\n\n<p>Os logs de mensagens e m\u00eddia s\u00e3o mantidos por apenas 60 dias, e se voc\u00ea quiser excluir mensagens a qualquer momento, poder\u00e1 faz\u00ea-lo usando este m\u00e9todo:<\/p>\n\n<p><a href=\"https:\/\/docs.ultramsg.com\/api\/post\/messages\/clear\" target=\"_blank\" rel=\"noopener\">https:\/\/docs.ultramsg.com\/api\/post\/messages\/clear<\/a><\/p>\n\n<h2 class=\"wp-block-heading\">Obter um relat\u00f3rio de mensagens por API <\/h2>\n\n<pre class=\"wp-block-code\"><code><a href=\"https:\/\/docs.ultramsg.com\/api\/get\/messages\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/docs.ultramsg.com\/api\/get\/messages<\/a><\/code><\/pre>\n\n<p>Voc\u00ea pode usar este m\u00e9todo para obter uma lista de mensagens de inst\u00e2ncia, voc\u00ea pode consultar mensagens de acordo com o status da mensagem (enviada, fila, n\u00e3o enviada).<\/p>\n\n<p><\/p>\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Seu cliente v\u00ea uma mensagem no aplicativo WhatsApp, mas n\u00e3o sabe que ela cruzou mais &#8230; <\/p>\n<p class=\"read-more-container\"><a title=\"Gerenciamento de mensagens e filas\" class=\"read-more button\" href=\"https:\/\/blog.ultramsg.com\/pt-br\/whatsapp-api-message-and-queue-management\/#more-3226\" aria-label=\"Read more about Gerenciamento de mensagens e filas\">Read More<\/a><\/p>\n","protected":false},"author":1,"featured_media":3114,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[111],"tags":[117],"class_list":["post-3226","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-api-do-whatsapp","tag-tutoriais","infinite-scroll-item","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-25","no-featured-image-padding"],"_links":{"self":[{"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/posts\/3226","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/comments?post=3226"}],"version-history":[{"count":6,"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/posts\/3226\/revisions"}],"predecessor-version":[{"id":5901,"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/posts\/3226\/revisions\/5901"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/media\/3114"}],"wp:attachment":[{"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/media?parent=3226"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/categories?post=3226"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.ultramsg.com\/pt-br\/wp-json\/wp\/v2\/tags?post=3226"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}