diff --git a/docs/queue/get-queue.md b/docs/queue/get-queue.md
index 686431dc..794f58ab 100644
--- a/docs/queue/get-queue.md
+++ b/docs/queue/get-queue.md
@@ -1,8 +1,15 @@
 ---
 id: get-queue
-title: Fila
+title: Fila (Antiga)
 ---
 
+:::danger Endpoint obsoleto e em descontinuação
+Este endpoint está **obsoleto**, pois o modelo de paginação foi atualizado para um formato baseado em **cursor (pagingState)**.
+**Descontinuação programada:** Este endpoint será removido em **30/04**.
+Recomendamos que todas as integrações sejam migradas para o novo endpoint [**POST /queue**](./post-queue), que utiliza o novo modelo de paginação.
+
+:::
+
 ## Método
 
 #### /queue
@@ -14,6 +21,7 @@ title: Fila
 |      Key       |            Value            |
 | :------------: |     :-----------------:     |
 |  Client-Token  | **[TOKEN DE SEGURANÇA DA CONTA](../security/client-token)** |
+
 ---
 
 ## Conceituação
@@ -28,17 +36,24 @@ Este método é responsável por retornar todas mensagens que estão em sua fila
 
 | Atributos | Tipo    | Descrição |
 | :-------- | :---:   | :-------- |
-| page      | integer | Utilizado para paginação você de informar aqui a pagina de mensagens que quer buscar |
-| pageSize  | integer | Especifica o tamanho do retorno de mensagens por pagina |
+| page      | integer | **Não possui mais efeito** |
+| pageSize  | integer | Especifica o tamanho do retorno de mensagens por página |
 
 ### Opcionais
 
-| Atributos | Tipo | Descrição |
-| :-------- | :--: | :-------- |
+| Atributos | Tipo   | Descrição |
+| :-------- | :--:   | :-------- |
 | count     | string | Atributo utilizado para retornar o número de mensagens na fila |
 
 ---
 
+## Regras de Paginação
+
+- O limite máximo de mensagens por página é **30**
+- O valor padrão (quando não informado) é **20**
+
+---
+
 ## Request Params
 
 #### URL exemplo
@@ -47,11 +62,10 @@ Método
 
 `GET` https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/queue?page=1&pageSize=100
 
- ou
+ou
 
 `GET` https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/queue/count
 
-
 ---
 
 ## Response
@@ -60,7 +74,7 @@ Método
 
 | Atributos | Tipo         | Descrição                       |
 | :-------- | :----------- | :------------------------------ |
-| messages  | array string | Array com as menssagens da fila |
+| messages  | array string | Array com as mensagens da fila  |
 
 Array Messages
 
@@ -69,13 +83,13 @@ Array Messages
 | _id          | string   | ID da mensagem no Z-API     |
 | DelayMessage | string   | Tempo em segundos entre o envio das mensagens |
 | Message      | string   | Texto da Mensagem           |
-| IsTrial      | boolean  | Indica se a instância está utilizando trial   |
+| IsTrial      | boolean  | Indica se a instância está utilizando trial |
 | InstanceId   | string   | ID da instância             |
 | Phone        | string   | Número do destinatário      |
 | ZaapId       | string   | ID da mensagem no Z-API     |
-| DelayTyping  | string   | Duração do indicador do chat "digitando..."   |
+| DelayTyping  | string   | Duração do indicador do chat "digitando..." |
 | MessageId    | string   | ID da mensagem              |
-| Created      | timetamp | Data da mensagem            |
+| Created      | timestamp | Data da mensagem           |
 
 Exemplo
 
@@ -92,8 +106,7 @@ Exemplo
       "ZaapId": "39BB1684570F00E91090F6BBC7EE7646",
       "DelayTyping": 0,
       "MessageId": "7AD29EAA5EF34C301F0B",
-      "Created": 1624977905648,
-      
+      "Created": 1624977905648
     },
     {
       "_id": "39BB1684570F00E91090F6BBC7EE7646",
@@ -105,7 +118,7 @@ Exemplo
       "ZaapId": "39BB1684570F00E91090F6BBC7EE7646",
       "DelayTyping": 5,
       "MessageId": "7AD29EAA5EF34C301F0B",
-      "Created": 1624977906907,
+      "Created": 1624977906907
     }
   ]
 }
diff --git a/docs/queue/post-queue.md b/docs/queue/post-queue.md
new file mode 100644
index 00000000..8d6f1fd5
--- /dev/null
+++ b/docs/queue/post-queue.md
@@ -0,0 +1,124 @@
+---
+id: post-queue
+title: Fila
+---
+
+## Método
+
+#### /queue
+
+`POST` https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/queue
+
+### Header
+
+|      Key       |            Value            |
+| :------------: |     :-----------------:     |
+|  Client-Token  | **[TOKEN DE SEGURANÇA DA CONTA](../security/client-token)** |
+
+---
+
+## Conceituação
+
+Este método é responsável por retornar mensagens da fila aguardando processamento.
+
+---
+
+## Body
+
+### Opcionais
+
+| Atributos   | Tipo    | Descrição |
+| :---------- | :--:    | :-------- |
+| pageSize    | integer | Quantidade de mensagens retornadas por requisição. O valor padrão é **20** e o limite máximo é **30** |
+| pagingState | string  | Cursor da página. Quando não informado, retorna a primeira página |
+
+---
+
+## Request Body
+
+### Exemplo
+
+**Para buscar a primeira página:**
+
+```json
+{}
+```
+
+**Para buscar a próxima página:**
+
+```json
+{
+  "pageSize": 20,
+  "pagingState": "eyJidWNrZXQiOjI5MzQsInBhZ2VTdGF0ZSI6IjAw..."
+}
+```
+
+---
+
+## Response
+
+### 200
+
+| Atributos   | Tipo    | Descrição |
+| :---------- | :------ | :-------- |
+| messages    | array   | Lista de mensagens da fila |
+| pagingState | string  | Cursor para próxima página |
+| hasMore     | boolean | Indica se existem mais páginas |
+
+---
+
+### Array Messages
+
+| Atributos    | Tipo      | Descrição |
+| :----------- | :-------- | :-------- |
+| _id          | string    | ID da mensagem no Z-API |
+| DelayMessage | integer   | Tempo entre envios |
+| Message      | string    | Texto da mensagem |
+| InstanceId   | string    | ID da instância |
+| Phone        | string    | Número ou grupo |
+| ZaapId       | string    | ID da mensagem |
+| DelayTyping  | integer   | Tempo do "digitando..." |
+| MessageId    | string    | ID da mensagem |
+| Created      | timestamp | Data em epoch |
+| CreatedAt    | string    | Data formatada |
+| Beta         | boolean   | Indica uso de beta |
+| IsTrial      | boolean   | Indica trial |
+
+---
+
+## Exemplo
+
+```json
+{
+  "messages": [
+    {
+      "DelayMessage": -1,
+      "Message": "Mensagem teste",
+      "InstanceId": "3E98XXXXXXXXXXXXXXXXXXXF5DDF",
+      "CreatedAt": "2026-03-31T14:40:31.776+00:00",
+      "ZaapId": "019D44XXXXXXXXXXXXXXXXX68DA6",
+      "DelayTyping": 0,
+      "Created": 1774968031776,
+      "Beta": false,
+      "IsTrial": false,
+      "Phone": "120XXXXXXXXXXX305-group",
+      "_id": "019D44XXXXXXXXXXXXXXXXX68DA6",
+      "MessageId": "ECFXXXXXXXXXXXXXX39"
+    }
+  ],
+  "pagingState": "eyJi...",
+  "hasMore": true
+}
+```
+
+---
+
+## Paginação
+
+- Caso não envie `pagingState`, a primeira página será retornada automaticamente
+- Caso não informe `pageSize`, o valor padrão de **20 mensagens** será utilizado
+- O limite máximo por requisição é de **30 mensagens**
+- Utilize o `pagingState` retornado para buscar as próximas páginas
+- Quando `hasMore` for `false`, não existem mais mensagens disponíveis
+
+---
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/queue/get-queue.md b/i18n/en/docusaurus-plugin-content-docs/current/queue/get-queue.md
index 23ccff0c..955fa614 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/queue/get-queue.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/queue/get-queue.md
@@ -1,8 +1,16 @@
 ---
 id: get-queue
-title: Queue 
+title: Queue (Legacy)
 ---
 
+:::danger Deprecated endpoint
+
+This endpoint is **deprecated**, as the pagination model has been updated to a **cursor-based approach (pagingState)**.
+**Scheduled deprecation:** This endpoint will be discontinued on **04/30**.
+We strongly recommend migrating all integrations to the new endpoint [**POST /queue**](./post-queue), which uses the updated pagination model.
+
+:::
+
 ## Method
 
 #### /queue
@@ -19,37 +27,43 @@ title: Queue
 
 ## Concept
 
-This method is responsible for returning all messages that are in your queue waiting to be processed. 
+This method returns all messages currently in the queue waiting to be processed.
 
 ---
 
-## Attributes 
+## Attributes
 
-### Required 
+### Required
 
 | Attributes | Type    | Description |
-| :--------  | :---:   | :-------- |
-| page       | integer | Used for pagination, you need to inform here the message page you want to retrieve |
-| pageSize   | integer | Specify the size of the message return per page |
+| :--------- | :---:   | :---------- |
+| page       | integer | **No longer has any effect** |
+| pageSize   | integer | Defines the number of messages returned per page |
 
+### Optional
 
-### Optionals 
+| Attributes | Type   | Description |
+| :--------- | :--:   | :---------- |
+| count      | string | Used to return the number of messages in the queue |
 
-| Attributes | Type | Description |
-| :-------- | :--: | :-------- |
-|           |      |           |
+---
+
+## Pagination Rules
+
+- The maximum number of messages per page is **30**
+- The default value (when not specified) is **20**
 
 ---
 
 ## Request Params
 
-#### URL example 
+#### Example URL
 
-Method 
+Method
 
 `GET` https://api.z-api.io/instances/YOUR_INSTANCE/token/YOUR_TOKEN/queue?page=1&pageSize=100
 
- or
+or
 
 `GET` https://api.z-api.io/instances/YOUR_INSTANCE/token/YOUR_TOKEN/queue/count
 
@@ -59,41 +73,53 @@ Method
 
 ### 200
 
-| Attributes | Type         | Description                       |
-| :-------- | :----------- | :------------------------------ |
-| size      | string       | Number of messages in queue    |
-| messages  | array string | Array with queue messages|
+| Attributes | Type         | Description                     |
+| :--------- | :----------- | :------------------------------ |
+| messages   | array string | Array containing queue messages |
 
-Messages Array 
+Messages Array
 
-| Attributes | Type     | Description                   |
-| :-------- | :------- | :-------------------------- |
-| size      | string   | Number of messages in queue |
-| Message   | string   | Text message                |
-| Phone     | string   | Recipients phone            |
-| ZaapId    | string   | Z-API message ID            |
-| Created   | timetamp | Messages date               |
-| MessageId | string   | Message ID                  |
+| Attributes   | Type     | Description |
+| :----------- | :------- | :---------- |
+| _id          | string   | Message ID in Z-API |
+| DelayMessage | string   | Delay in seconds between message sends |
+| Message      | string   | Message text |
+| IsTrial      | boolean  | Indicates if the instance is using trial mode |
+| InstanceId   | string   | Instance ID |
+| Phone        | string   | Recipient phone number |
+| ZaapId       | string   | Message ID in Z-API |
+| DelayTyping  | string   | Duration of the "typing..." indicator |
+| MessageId    | string   | Message ID |
+| Created      | timestamp | Message timestamp |
 
-Example 
+Example
 
 ```json
 {
-  "size": 2,
-  "messages": [
+  [
     {
-      "Message": "Mensagem da fila 1",
+      "_id": "39BB1684570F00E91090F6BBC7EE7646",
+      "DelayMessage": -1,
+      "Message": "Queue message 1",
+      "IsTrial": false,
+      "InstanceId": "3A5D07856DC26A1C9E2E08E691E63271",
       "Phone": "5511999999999",
       "ZaapId": "39BB1684570F00E91090F6BBC7EE7646",
-      "Created": 1624977905648,
-      "MessageId": "7AD29EAA5EF34C301F0B"
+      "DelayTyping": 0,
+      "MessageId": "7AD29EAA5EF34C301F0B",
+      "Created": 1624977905648
     },
     {
-      "Message": "Mensagem da fila 2",
+      "_id": "39BB1684570F00E91090F6BBC7EE7646",
+      "DelayMessage": -1,
+      "Message": "Queue message 2",
+      "IsTrial": false,
+      "InstanceId": "3A5D07856DC26A1C9E2E08E691E63271",
       "Phone": "5511999999999",
-      "ZaapId": "39BB1685172AB008542A7E0B862A54DF",
-      "Created": 1624977906907,
-      "MessageId": "517AEF0FDE834DADJJFC8"
+      "ZaapId": "39BB1684570F00E91090F6BBC7EE7646",
+      "DelayTyping": 5,
+      "MessageId": "7AD29EAA5EF34C301F0B",
+      "Created": 1624977906907
     }
   ]
 }
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/queue/post-queue.md b/i18n/en/docusaurus-plugin-content-docs/current/queue/post-queue.md
new file mode 100644
index 00000000..cf4df592
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/queue/post-queue.md
@@ -0,0 +1,124 @@
+---
+id: post-queue
+title: Queue
+---
+
+## Method
+
+#### /queue
+
+`POST` https://api.z-api.io/instances/YOUR_INSTANCE/token/YOUR_TOKEN/queue
+
+### Header
+
+|      Key       |            Value            |
+| :------------: |     :-----------------:     |
+|  Client-Token  | **[ACCOUNT SECURITY TOKEN](../security/client-token)** |
+
+---
+
+## Overview
+
+This method returns messages from the queue that are waiting to be processed.
+
+---
+
+## Body
+
+### Optional
+
+| Attributes   | Type    | Description |
+| :----------- | :--:    | :---------- |
+| pageSize     | integer | Number of messages returned per request. The default value is **20** and the maximum limit is **30** |
+| pagingState  | string  | Page cursor. If not provided, the first page will be returned |
+
+---
+
+## Request Body
+
+### Example
+
+**To fetch the first page:**
+
+```json
+{}
+```
+
+**To fetch the next page:**
+
+```json
+{
+  "pageSize": 20,
+  "pagingState": "eyJidWNrZXQiOjI5MzQsInBhZ2VTdGF0ZSI6IjAw..."
+}
+```
+
+---
+
+## Response
+
+### 200
+
+| Attributes  | Type    | Description |
+| :---------- | :------ | :---------- |
+| messages    | array   | List of queue messages |
+| pagingState | string  | Cursor for the next page |
+| hasMore     | boolean | Indicates if there are more pages available |
+
+---
+
+### Messages Array
+
+| Attributes    | Type      | Description |
+| :------------ | :-------- | :---------- |
+| _id           | string    | Message ID in Z-API |
+| DelayMessage  | integer   | Delay between messages (seconds) |
+| Message       | string    | Message content |
+| InstanceId    | string    | Instance ID |
+| Phone         | string    | Recipient number or group |
+| ZaapId        | string    | Message ID in Z-API |
+| DelayTyping   | integer   | Typing indicator duration |
+| MessageId     | string    | Message ID |
+| Created       | timestamp | Message timestamp (epoch) |
+| CreatedAt     | string    | Formatted message date |
+| Beta          | boolean   | Indicates beta feature usage |
+| IsTrial       | boolean   | Indicates if the instance is in trial mode |
+
+---
+
+## Example
+
+```json
+{
+  "messages": [
+    {
+      "DelayMessage": -1,
+      "Message": "Test message",
+      "InstanceId": "3E98XXXXXXXXXXXXXXXXXXXF5DDF",
+      "CreatedAt": "2026-03-31T14:40:31.776+00:00",
+      "ZaapId": "019D44XXXXXXXXXXXXXXXXX68DA6",
+      "DelayTyping": 0,
+      "Created": 1774968031776,
+      "Beta": false,
+      "IsTrial": false,
+      "Phone": "120XXXXXXXXXXX305-group",
+      "_id": "019D44XXXXXXXXXXXXXXXXX68DA6",
+      "MessageId": "ECFXXXXXXXXXXXXXX39"
+    }
+  ],
+  "pagingState": "eyJi...",
+  "hasMore": true
+}
+```
+
+---
+
+## Pagination
+
+- If `pagingState` is not provided, the first page will be returned automatically
+- If `pageSize` is not provided, the default value of **20 messages** will be used
+- The maximum limit per request is **30 messages**
+- Use the returned `pagingState` to fetch the next pages
+- When `hasMore` is `false`, there are no more messages available
+
+---
\ No newline at end of file
diff --git a/sidebars.js b/sidebars.js
index 79807430..3823ead0 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -225,6 +225,7 @@ module.exports = {
     ],
     'Message queue': [
       'queue/introduction',
+      'queue/post-queue',
       'queue/get-queue',
       'queue/delete-queue',
       'queue/delete-queue-id',