> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sincronização de modelos

## I. Instruções da interface

### 1. Exemplo de solicitação:

```hurl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST 'https://api.ycloud.com/v2/whatsapp/templates/{wabaId}/sync' \
-H 'X-API-Key: {{YOUR-API-KEY}}'
```

### 2. Payloads de solicitação:

Parâmetros de caminho

| Nome do parâmetro | Tipo | Obrigatório | Observação |
| - | - | - | - |
| wabaId | String | Sim | ID da conta do WhatsApp Business |

Parâmetros de cabeçalho

| Nome do parâmetro | Tipo | Obrigatório | Observação |
| - | - | - | - |
| X-API-KEY | String | Sim | Chave de API da sua conta YCloud |

### 3. Detalhes da resposta

Respondido com sucesso (200 OK)

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "wabaId": "string",
  "message": "string"
}
```

Informações do parâmetro:

| Nome | Tipo | Observação |
| - | - | - |
| wabaId | String | ID da conta do WhatsApp Business |
| message | String | Informações de status da sincronização |

Exemplo de resposta:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "wabaId": "123456789012345",
  "message": "Template sync has been triggered. It may take a few minutes to complete. If templates were recently migrated to this WABA on Meta, the system will automatically retry for up to 30 minutes."
}
```

## II: Especificações da interface

### 1. Verificação de autorização

* Esta interface é apenas para parceiros de desenvolvimento técnico.
* É exclusivamente para contas WABA já vinculadas à YCloud.

### 2. Restrição de frequência

Esta interface possui restrições de frequência de camada dupla, ou seja, restrições no nível do WABA e restrições no nível do locatário. Se você estiver preocupado com essa restrição, entre em contato com a equipe da YCloud.

Restrição do WABA

* Janela de tempo: 10 minutos
* Política de restrição: Cada WABA pode iniciar apenas uma solicitação de sincronização dentro da janela de tempo.
* Mensagem de erro: "Template sync for this WABA was recently triggered. Please try again later."

Restrição do locatário

* Janela de tempo: 1 hora
* Máximo de solicitações: 20 vezes
* Política de restrição: Cada locatário pode iniciar até 20 solicitações de sincronização dentro da janela de tempo.
* Mensagem de erro: "Too many template sync requests from the tenant. Please try again later."

### 3. Nova tentativa automática

Quando a plataforma da Meta retorna uma lista de modelos vazia, o sistema tentará novamente de forma automática:

* Máximo de novas tentativas: 3 vezes
* Intervalo de nova tentativa: 5 minutos → 10 minutos → 15 minutos
* Duração total das novas tentativas: 30 minutos

### 4. Código de erro

| 403 | FORBIDDEN | Esta API está disponível apenas para parceiros TP. |
| - | - | - |
| 403 | FORBIDDEN | O WABA não está vinculado a uma conta YCloud |
| 429 | TOO\_MANY\_REQUESTS | Excedeu o limite de frequência no nível do WABA |
| 429 | TOO\_MANY\_REQUESTS | Excedeu o limite de frequência no nível do locatário |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.