@seedgrid/ai-toolkit 0.0.0-stage → 0.3.1

package/seedgridKB/SeedGrid/Extensions/whatsapp/Configuracao.md

@@ -0,0 +1,152 @@
+---
+tags: [seedgrid, extension, whatsapp, configuracao]
+fonte: java/seedgrid-quarkus-ext-whatsapp
+branch: main
+commit: d8454f6313
+analisado-em: 2026-10-14
+---
+
+# Configuração — seedgrid-whatsapp (Quarkus)
+
+Voltar: [[SeedGrid/Extensions/whatsapp/Visao-geral|Visão geral do whatsapp]] · [[SeedGrid/Extensions/whatsapp/Exemplos|Exemplos do whatsapp]] · [[SeedGrid/Extensions/whatsapp/Configuracao-Rust|Configuração do porte Rust]]
+
+## 1. Cabeçalho
+
+| Item | Valor |
+|---|---|
+| Prefixo | `seedgrid.whatsapp` |
+| Classes de config | `WhatsAppConfig` (só `api`) e `WhatsAppProviderConfig` (`evolution`, `cloud`, `rest-client`) — **duas** interfaces `@ConfigMapping` com o **mesmo** prefixo |
+| Mecanismo | `@ConfigMapping` (SmallRye) + `@ConfigRoot(phase = ConfigPhase.RUN_TIME)` |
+| Fase | Runtime (todas) |
+| Defaults embutidos | `seedgrid-whatsapp-core/src/main/resources/META-INF/microprofile-config.properties` (ordinal 100; o `application.properties` do app sobrescreve) |
+| Ponte para o Rest Client | `application.properties` dentro dos jars `seedgrid-whatsapp-evolution` e `seedgrid-whatsapp-whatsapp-cloud` mapeiam `quarkus.rest-client.<configKey>.url` para as propriedades `seedgrid.whatsapp.rest-client.*` |
+| Seleção de bean | `@LookupIfProperty(name = "seedgrid.whatsapp.api", stringValue = ...)` em `EvolutionWhatsAppApi` e `OfficialCloudWhatsAppApi` + `WhatsAppApiProducer#produce()` |
+
+Arquivos de declaração (caminhos relativos a `seedgrid-platform`):
+- `java/seedgrid-quarkus-ext-whatsapp/seedgrid-whatsapp-core/src/main/java/br/com/seedgrid/whatsapp/configs/WhatsAppConfig.java`
+- `java/seedgrid-quarkus-ext-whatsapp/seedgrid-whatsapp-core/src/main/java/br/com/seedgrid/whatsapp/configs/WhatsAppProviderConfig.java`
+- `java/seedgrid-quarkus-ext-whatsapp/seedgrid-whatsapp-core/src/main/resources/META-INF/microprofile-config.properties`
+
+Não há `*BuildTimeConfig` no deployment (`WhatsAppCoreProcessor` não lê config) nem `@ConfigProperty`/`ConfigProvider` no código de produção (**Confirmado** por busca).
+
+## 2. Propriedades da extension
+
+Abreviações de origem: `core/…` = `java/seedgrid-quarkus-ext-whatsapp/seedgrid-whatsapp-core/src/main/…`; `evo/…` = `java/seedgrid-quarkus-ext-whatsapp/seedgrid-whatsapp-evolution/src/main/…`; `cloud/…` = `java/seedgrid-quarkus-ext-whatsapp/seedgrid-whatsapp-whatsapp-cloud/src/main/…`.
+
+### 2.1 Seleção do provider
+
+| Propriedade | Tipo | Valores aceitos | Padrão | Obrigatória | Comportamento | Uso | Relações | Fase | Origem |
+|---|---|---|---|---|---|---|---|---|---|
+| `seedgrid.whatsapp.api` | `String` | `default`, `evolution`, `whatsapp-cloud` (enum [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppProvider\|WhatsAppProvider]]: `DEFAULT`, `EVOLUTION`, `OFFICIAL`) | `default` (`@WithDefault("default")`; também `${SEEDGRID_WHATSAPP_API:default}` no `microprofile-config.properties`) | Não | `WhatsAppProvider.fromConfig` faz `trim().toLowerCase()`; valor vazio ou desconhecido vira `DEFAULT`. `DEFAULT` → `DefaultWhatsAppApi` (só registra WARNING e devolve resultado vazio). `evolution`/`whatsapp-cloud` → bean do provider **se** resolvível via `Instance` (módulo no classpath e `@LookupIfProperty` casando); senão cai no `DefaultWhatsAppApi` silenciosamente (**Confirmado**). | Escolher o provider injetado em `WhatsAppApi` | Ativa `@LookupIfProperty` de `EvolutionWhatsAppApi` (`evolution`) e `OfficialCloudWhatsAppApi` (`whatsapp-cloud`). **Inferência:** `@LookupIfProperty` compara o texto exato, então `Evolution`/` evolution ` seria aceito pelo `fromConfig` mas não pelo lookup → fallback para Default. | Runtime | Decl.: `core/java/.../configs/WhatsAppConfig.java` → `WhatsAppConfig#api()`; consumo: `core/java/.../services/WhatsAppApiProducer.java` → `produce()`, `core/java/.../enums/WhatsAppProvider.java` → `fromConfig`, `evo/java/.../services/EvolutionWhatsAppApi.java` (`@LookupIfProperty`), `cloud/java/.../services/OfficialCloudWhatsAppApi.java` (`@LookupIfProperty`) |
+
+### 2.2 Provider Evolution API
+
+| Propriedade | Tipo | Valores aceitos | Padrão | Obrigatória | Comportamento | Uso | Relações | Fase | Origem |
+|---|---|---|---|---|---|---|---|---|---|
+| `seedgrid.whatsapp.evolution.api-key` 🔒 | `Optional<String>` | texto não vazio | — (no `microprofile-config.properties`: `${SEEDGRID_WHATSAPP_EVOLUTION_API_KEY:}`, ou seja vazio) | Condicional: obrigatória quando `api=evolution` | Lida a cada chamada por `requireApiKey()`; vazia/ausente → `IllegalStateException("Missing required config 'seedgrid.whatsapp.evolution.api-key' for provider 'evolution'.")` no momento da chamada (não no boot). Enviada no header HTTP `apikey`. | Autenticação na Evolution API | Só tem efeito com `seedgrid.whatsapp.api=evolution` (ou injeção direta de `EvolutionWhatsAppApi`) | Runtime | Decl.: `core/java/.../configs/WhatsAppProviderConfig.java` → `Evolution#apiKey()`; consumo: `evo/java/.../services/EvolutionWhatsAppApi.java` → `requireApiKey()`; header em `evo/java/.../clients/EvolutionRestClient.java` (`@HeaderParam("apikey")`) |
+| `seedgrid.whatsapp.rest-client.evolution.url` | `Optional<String>` | URL base da Evolution (ex.: `https://<host-evolution>`) | — (no `microprofile-config.properties`: `${SEEDGRID_WHATSAPP_REST_CLIENT_EVOLUTION_URL:}`, vazio) | Condicional: obrigatória quando `api=evolution` | Funciona via ponte: é consumida pela expressão `quarkus.rest-client.evolution.url=${seedgrid.whatsapp.rest-client.evolution.url:}` do `application.properties` do jar evolution, que define a base do `EvolutionRestClient` (`configKey = "evolution"`). **Inferência:** sem URL, o Rest Client falha ao ser criado/usado (mensagem do Quarkus sobre base URL ausente). | URL base do `EvolutionRestClient` | Alimenta `quarkus.rest-client.evolution.url` (ver seção 3) | Runtime | Decl.: `core/java/.../configs/WhatsAppProviderConfig.java` → `RestClient.EvolutionRest#url()`; ponte: `evo/resources/application.properties`; consumo: `evo/java/.../clients/EvolutionRestClient.java` (`@RegisterRestClient(configKey = "evolution")`) |
+
+### 2.3 Provider WhatsApp Cloud API (Meta Graph API)
+
+| Propriedade | Tipo | Valores aceitos | Padrão | Obrigatória | Comportamento | Uso | Relações | Fase | Origem |
+|---|---|---|---|---|---|---|---|---|---|
+| `seedgrid.whatsapp.cloud.access-token` 🔒 | `Optional<String>` | token de acesso da Graph API | — (no `microprofile-config.properties`: `${SEEDGRID_WHATSAPP_CLOUD_ACCESS_TOKEN:}`, vazio) | Condicional: obrigatória quando `api=whatsapp-cloud` | Lida a cada chamada por `bearer()`; vazia/ausente → `IllegalStateException("Missing required config 'seedgrid.whatsapp.cloud.access-token' for provider 'whatsapp-cloud'.")`. Enviada como `Authorization: Bearer <token>`. | Autenticação na Graph API | Só com `seedgrid.whatsapp.api=whatsapp-cloud` | Runtime | Decl.: `core/java/.../configs/WhatsAppProviderConfig.java` → `Cloud#accessToken()`; consumo: `cloud/java/.../clients/services/OfficialCloudWhatsAppApi.java` → `bearer()`; header em `cloud/java/.../clients/CloudRestClient.java` (`@HeaderParam("Authorization")`) |
+| `seedgrid.whatsapp.rest-client.cloud.url` | `String` | URL base da Graph API com versão | `https://graph.facebook.com/v21.0` (`@WithDefault` e `${SEEDGRID_WHATSAPP_REST_CLIENT_CLOUD_URL:https://graph.facebook.com/v21.0}`) | Não | Funciona via ponte: é consumida por `quarkus.rest-client.cloud.url=${seedgrid.whatsapp.rest-client.cloud.url:}` no jar cloud. Endpoints usados: `POST /{phoneNumberId}/messages` e `POST /{phoneNumberId}/media`. | URL base do `CloudRestClient` | Alimenta `quarkus.rest-client.cloud.url` (ver seção 3) | Runtime | Decl.: `core/java/.../configs/WhatsAppProviderConfig.java` → `RestClient.CloudRest#url()`; ponte: `cloud/resources/application.properties`; consumo: `cloud/java/.../clients/CloudRestClient.java` (`@RegisterRestClient(configKey = "cloud")`) |
+
+### Variáveis de ambiente
+
+O `microprofile-config.properties` do core lê explicitamente estas variáveis (via expressão `${ENV:padrão}`) — **Confirmado**:
+
+| Propriedade | Variável lida |
+|---|---|
+| `seedgrid.whatsapp.api` | `SEEDGRID_WHATSAPP_API` |
+| `seedgrid.whatsapp.rest-client.evolution.url` | `SEEDGRID_WHATSAPP_REST_CLIENT_EVOLUTION_URL` |
+| `seedgrid.whatsapp.evolution.api-key` 🔒 | `SEEDGRID_WHATSAPP_EVOLUTION_API_KEY` |
+| `seedgrid.whatsapp.rest-client.cloud.url` | `SEEDGRID_WHATSAPP_REST_CLIENT_CLOUD_URL` |
+| `seedgrid.whatsapp.cloud.access-token` 🔒 | `SEEDGRID_WHATSAPP_CLOUD_ACCESS_TOKEN` |
+
+Os mesmos nomes também resultam da regra MicroProfile (env source, ordinal 300). Um `application.properties` do app (ordinal 250) que defina a propriedade explicitamente vence a expressão do `microprofile-config.properties` (ordinal 100), mas perde para a env var pela regra padrão.
+
+## 3. Propriedades de framework (quarkus.*)
+
+| Propriedade | Tipo | Valores aceitos | Padrão | Obrigatória | Comportamento | Uso | Relações | Fase | Origem |
+|---|---|---|---|---|---|---|---|---|---|
+| `quarkus.rest-client.evolution.url` | `String` | URL | `${seedgrid.whatsapp.rest-client.evolution.url:}` (definido pela lib) | Condicional (provider evolution) | Base URL do `EvolutionRestClient`. A lib define a ponte; o app pode sobrescrever diretamente. | Rest Client Evolution | Derivada de `seedgrid.whatsapp.rest-client.evolution.url` | Runtime | `evo/resources/application.properties`; `EvolutionRestClient` |
+| `quarkus.rest-client.cloud.url` | `String` | URL | `${seedgrid.whatsapp.rest-client.cloud.url:}` (definido pela lib) | Não (herda default `https://graph.facebook.com/v21.0`) | Base URL do `CloudRestClient`. | Rest Client Cloud | Derivada de `seedgrid.whatsapp.rest-client.cloud.url` | Runtime | `cloud/resources/application.properties`; `CloudRestClient` |
+
+Observações:
+- **Inferência:** a ponte depende de o Quarkus carregar `application.properties` presentes em jars de dependência (o SmallRye carrega todos os recursos `application.properties` do classpath com ordinal 250). Se o app também tiver `quarkus.rest-client.evolution.url`, há duas fontes com o mesmo ordinal — prefira definir `seedgrid.whatsapp.rest-client.*` e não a chave `quarkus.*` diretamente, ou defina ambas com o mesmo valor. Não confirmado em execução.
+- Demais chaves `quarkus.rest-client.evolution.*` / `quarkus.rest-client.cloud.*` (timeouts, `scope`, proxy etc.) são do Quarkus e não são definidas pela lib; o teste usa `quarkus.rest-client.evolution.scope=jakarta.inject.Singleton` (seção 4).
+- O deployment (`WhatsAppCoreProcessor`) apenas registra a feature `seedgrid-whatsapp-core`, indexa `seedgrid-whatsapp-evolution` e `seedgrid-whatsapp-whatsapp-cloud` e registra `DefaultWhatsAppApi`/`WhatsAppApiProducer` como beans não removíveis — não lê config.
+
+## 4. Propriedades usadas só em testes
+
+Fonte: `java/seedgrid-quarkus-ext-whatsapp/seedgrid-whatsapp-evolution/src/test/resources/application.properties` e testes em `seedgrid-whatsapp-evolution/src/test/java`. Valores reais (URL do servidor, chave, instância) existem commitados no repositório e **não** são reproduzidos aqui.
+
+| Propriedade | Tipo | Valores aceitos | Padrão | Obrigatória | Comportamento | Uso | Relações | Fase | Origem |
+|---|---|---|---|---|---|---|---|---|---|
+| `evolution.api.key` 🔒 | `String` | chave | — | Sim (nos ITs) | Injetada por `@ConfigProperty` | `EvolutionRestClientIT` chama o Rest Client diretamente com a chave | Duplicada de `seedgrid.whatsapp.evolution.api-key` | Runtime (teste) | `src/test/.../clients/EvolutionRestClientIT.java` |
+| `evolution.instance.name` | `String` | nome de instância | — | Sim (nos ITs) | Injetada por `@ConfigProperty` | Instância alvo dos ITs | — | Runtime (teste) | `EvolutionRestClientIT`, `src/test/.../services/EvolutionWhatsAppApiIT.java` |
+| `evolution.live` (system property) | `boolean` | `true` | — | Condicional | `@EnabledIfSystemProperty(named = "evolution.live", matches = "true")` habilita `EvolutionRestClientIT` | Liga testes contra servidor real | — | Execução de teste | `EvolutionRestClientIT` |
+| `quarkus.rest-client.evolution.scope` | `String` | escopo CDI | — | Não | Define `jakarta.inject.Singleton` para o client nos testes | — | — | Runtime (teste) | `src/test/resources/application.properties` |
+| `quarkus.log.level` | `String` | nível de log | — | Não | `INFO` nos testes | — | — | Runtime (teste) | idem |
+| `quarkus.log.category."br.com.seedgrid.whatsapp".level` | `String` | nível de log | — | Não | `DEBUG` nos testes | — | — | Runtime (teste) | idem |
+
+O mesmo arquivo de teste também define `seedgrid.whatsapp.api=evolution`, `seedgrid.whatsapp.rest-client.evolution.url` e `seedgrid.whatsapp.evolution.api-key` (propriedades públicas da seção 2). `EvolutionWhatsAppApiIT` lê `quarkus.rest-client.evolution.url` via `@ConfigProperty` e **não** tem guarda `@EnabledIf…`; como o surefire usa os includes padrão (`*Test`, `Test*`, `*Tests`, `*TestCase`), classes `*IT` não rodam em `mvn test` sem `-Dtest=...` (**Inferência** — o pom não customiza includes).
+
+## 5. Aliases, obsoletas, renomeações
+
+- Nenhum alias declarado (sem `@WithName` alternativo nem fallback de chave).
+
+## 6. Configuração mínima
+
+Evolution:
+```properties
+seedgrid.whatsapp.api=evolution
+seedgrid.whatsapp.rest-client.evolution.url=<URL-DA-EVOLUTION-API>
+seedgrid.whatsapp.evolution.api-key=<SEGREDO:evolution-api-key>
+```
+
+WhatsApp Cloud (Meta):
+```properties
+seedgrid.whatsapp.api=whatsapp-cloud
+seedgrid.whatsapp.cloud.access-token=<SEGREDO:whatsapp-cloud-access-token>
+# seedgrid.whatsapp.rest-client.cloud.url já tem padrão https://graph.facebook.com/v21.0
+```
+
+## 7. Configuração completa comentada
+
+```properties
+# Provider usado por WhatsAppApi: default | evolution | whatsapp-cloud
+# default (padrão) = DefaultWhatsAppApi, que só loga WARNING e não envia nada.
+seedgrid.whatsapp.api=evolution
+
+# --- Evolution API (necessário o jar seedgrid-whatsapp-evolution) ---
+# URL base; repassada para quarkus.rest-client.evolution.url pela própria lib. Sem padrão.
+seedgrid.whatsapp.rest-client.evolution.url=<URL-DA-EVOLUTION-API>
+# Enviada no header "apikey". Sem padrão; ausente => IllegalStateException na chamada.
+seedgrid.whatsapp.evolution.api-key=<SEGREDO:evolution-api-key>
+
+# --- WhatsApp Cloud API (necessário o jar seedgrid-whatsapp-whatsapp-cloud) ---
+# URL base da Graph API. Padrão: https://graph.facebook.com/v21.0
+seedgrid.whatsapp.rest-client.cloud.url=https://graph.facebook.com/v21.0
+# Enviado como "Authorization: Bearer ...". Sem padrão; ausente => IllegalStateException na chamada.
+seedgrid.whatsapp.cloud.access-token=<SEGREDO:whatsapp-cloud-access-token>
+
+# --- Opcional: ajustes do Quarkus Rest Client (chaves do framework) ---
+# quarkus.rest-client.evolution.scope=jakarta.inject.Singleton
+```
+
+## 8. Receitas
+
+- **Desligar envio (dev/local):** não defina `seedgrid.whatsapp.api` (ou use `default`). Toda chamada de `WhatsAppApi` loga `DefaultWhatsAppApi invoked: ... Configure seedgrid.whatsapp.api to enable a provider.` e retorna `WhatsAppSendMessageResultDTO.empty()`.
+- **Evolution self-hosted:** dependências `seedgrid-whatsapp-core` + `seedgrid-whatsapp-evolution`; configuração mínima Evolution acima. Use `channelId` = nome da instância Evolution. Gestão de instância/grupos/labels/chat via interfaces específicas (ver [[SeedGrid/Extensions/whatsapp/Exemplos|Exemplos]]).
+- **Meta Cloud API:** dependências `seedgrid-whatsapp-core` + `seedgrid-whatsapp-whatsapp-cloud`; `channelId` = `PHONE_NUMBER_ID` (README). Para fixar outra versão da Graph API, altere `seedgrid.whatsapp.rest-client.cloud.url` (ex.: `https://graph.facebook.com/v<versão>`).
+- **Segredos por ambiente:** exporte `SEEDGRID_WHATSAPP_EVOLUTION_API_KEY` / `SEEDGRID_WHATSAPP_CLOUD_ACCESS_TOKEN` em vez de gravar no `application.properties`.
+
+## 9. Dúvidas e lacunas
+
+- As URLs `seedgrid.whatsapp.rest-client.*` chegam ao Rest Client exclusivamente pela ponte no `application.properties` dos jars de provider (o Quarkus carrega `application.properties` de todo o classpath; o próprio `EvolutionRestClientIT` configura só a chave `seedgrid.whatsapp.*`). Para sobrescrever, o host pode definir a chave `seedgrid.whatsapp.rest-client.*` ou diretamente `quarkus.rest-client.<configKey>.url`.
+- Valores com maiúsculas/espaços em `seedgrid.whatsapp.api` são normalizados pelo producer mas não pelo `@LookupIfProperty` (Inferência) → fallback silencioso para `DefaultWhatsAppApi`.
+- Não há validação no boot: credenciais ausentes só falham na primeira chamada (`IllegalStateException`).
+- Mapeamento para o crate Rust: ver [[SeedGrid/Extensions/whatsapp/Configuracao-Rust|Configuração do porte Rust]].

package/seedgridKB/SeedGrid/Extensions/whatsapp/Enums.md

@@ -0,0 +1,198 @@
+---
+tags: [seedgrid, extension, whatsapp, enum]
+fonte: java/seedgrid-quarkus-ext-whatsapp
+branch: main
+commit: d8454f6313
+analisado-em: 2026-10-14
+---
+
+# Enums — seedgrid-whatsapp (Quarkus)
+
+Voltar: [[SeedGrid/Extensions/whatsapp/Visao-geral|Visão geral do whatsapp]] · [[SeedGrid/Extensions/whatsapp/Configuracao|Configuração]] · [[SeedGrid/Extensions/whatsapp/Rust|Porte Rust]]
+
+Todos os enums ficam em `seedgrid-whatsapp-core/src/main/java/br/com/seedgrid/whatsapp/enums/` (pacote `br.com.seedgrid.whatsapp.enums`). São 12, todos públicos. Nenhum é persistido (a extension não tem entidades nem migrations) e só `WhatsAppProvider` é lido de config.
+
+## Índice
+
+| Enum | Arquivo | Usado em | Público? |
+|---|---|---|---|
+| [[#WhatsAppProvider]] | `WhatsAppProvider.java` | propriedade `seedgrid.whatsapp.api` | Sim |
+| [[#WhatsAppMediaType]] | `WhatsAppMediaType.java` | `WhatsAppMediaMessageFileDTO`, `WhatsAppMediaMessageURLDTO` | Sim |
+| [[#WhatsAppPresence]] | `WhatsAppPresence.java` | `WhatsAppInstanceManagementApi#setPresence`, `WhatsAppChatApi#sendPresence` | Sim |
+| [[#WhatsAppBlockAction]] | `WhatsAppBlockAction.java` | `WhatsAppChatApi#updateBlockStatus` | Sim |
+| [[#WhatsAppLabelAction]] | `WhatsAppLabelAction.java` | `WhatsAppLabelApi#handleLabel` | Sim |
+| [[#WhatsAppGroupParticipantAction]] | `WhatsAppGroupParticipantAction.java` | `WhatsAppGroupApi#updateParticipants` | Sim |
+| [[#WhatsAppGroupSetting]] | `WhatsAppGroupSetting.java` | `WhatsAppGroupApi#updateGroupSetting` | Sim |
+| [[#WhatsAppEphemeralExpiration]] | `WhatsAppEphemeralExpiration.java` | `WhatsAppGroupApi#toggleEphemeral` | Sim |
+| [[#WhatsAppPrivacyValue]] | `WhatsAppPrivacyValue.java` | `WhatsAppPrivacySettings.profile/status/last` | Sim |
+| [[#WhatsAppReadReceiptsValue]] | `WhatsAppReadReceiptsValue.java` | `WhatsAppPrivacySettings.readreceipts` | Sim |
+| [[#WhatsAppOnlinePrivacyValue]] | `WhatsAppOnlinePrivacyValue.java` | `WhatsAppPrivacySettings.online` | Sim |
+| [[#WhatsAppGroupAddPrivacyValue]] | `WhatsAppGroupAddPrivacyValue.java` | `WhatsAppPrivacySettings.groupadd` | Sim |
+
+Padrão comum: cada constante guarda um texto (`value`/`configValue`) e há um `fromValue`/`fromConfig` com busca linear **case-sensitive** que lança `WhatsAppException("Unexpected value '<v>'")` quando não acha (exceto `WhatsAppProvider`, que cai em `DEFAULT`). Os enums de ação **não** têm `@JsonValue`: quem os serializa é a `EvolutionWhatsAppApi`, que põe `getValue()` no `Map` do payload.
+
+## WhatsAppProvider
+
+`seedgrid-whatsapp-core/.../enums/WhatsAppProvider.java` · `br.com.seedgrid.whatsapp.enums.WhatsAppProvider`
+
+| Valor | Significado | Efeito / onde é tratado | Observações |
+|---|---|---|---|
+| `DEFAULT` (`default`) | Provider no-op | `WhatsAppApiProducer#produce()` devolve `DefaultWhatsAppApi` | Também é o resultado para config vazia/desconhecida (**Confirmado**) |
+| `EVOLUTION` (`evolution`) | Evolution API | `produce()` devolve o bean `@EvolutionProvider` se `Instance.isResolvable()`, senão `DefaultWhatsAppApi` | **Confirmado** |
+| `OFFICIAL` (`whatsapp-cloud`) | WhatsApp Cloud (Meta) | `produce()` devolve o bean `@OfficialProvider` se resolvível, senão `DefaultWhatsAppApi` | O texto de config é `whatsapp-cloud`, **não** `official` (**Confirmado**) |
+
+- Campo `configValue` (`getConfigValue()`); `static fromConfig(String)`: `null`/em branco → `DEFAULT`; senão `trim().toLowerCase()` e compara; sem match → `DEFAULT` (nunca lança).
+- Config: lido de `seedgrid.whatsapp.api` (tipo `String` em `WhatsAppConfig`, convertido manualmente por `fromConfig`, logo tolerante a caixa e espaços). Sem JSON, sem persistência.
+- `@LookupIfProperty` dos beans compara o texto exato; `Evolution` passa no `fromConfig` mas pode não casar o lookup e cair em Default (**Inferência**, ver [[SeedGrid/Extensions/whatsapp/Configuracao|Configuração]]).
+- Usado em: [[SeedGrid/Extensions/whatsapp/Configuracao|seedgrid.whatsapp.api]].
+
+## WhatsAppMediaType
+
+`.../enums/WhatsAppMediaType.java` · `br.com.seedgrid.whatsapp.enums.WhatsAppMediaType`
+
+| Valor | Significado | Efeito / onde é tratado | Observações |
+|---|---|---|---|
+| `NONE` (`none`) | Sem mídia | Nenhum código o trata de forma especial; `getValue()` = `"none"` segue para o payload | Existe no enum, mas nenhum código trata esse valor. Enviado como `mediatype: "none"` (Evolution) / `type: "none"` (Cloud); provavelmente recusado pelo provider (**Inferência**) |
+| `IMAGE` (`image`) | Imagem | `getValue()` vai em `EvolutionPayloads.media(...)` (`mediatype`) e em `OfficialCloudWhatsAppApi` (`type`) | **Confirmado** |
+| `VIDEO` (`video`) | Vídeo | idem | **Confirmado** |
+| `AUDIO` (`audio`) | Áudio | idem | **Confirmado** |
+| `DOCUMENT` (`document`) | Documento | idem | **Confirmado** |
+
+- Campo `value` (não-final), `getValue()`, `static fromValue(String)`.
+- Serialização: **sem** `@JsonValue`/`@JsonCreator`. Se a aplicação serializar os DTOs (records) com Jackson, o JSON usa o nome da constante (`IMAGE`), não `image` (**Inferência**). A extension só usa `getValue()` ao montar payloads. `mediaType` nulo causa `NullPointerException` em `sendMediaFile`/`sendMediaUrl` (sem validação, **Confirmado**).
+- Usado em: `WhatsAppMediaMessageFileDTO#mediaType`, `WhatsAppMediaMessageURLDTO#mediaType`; `EvolutionWhatsAppApi#sendMediaFile/sendMediaUrl`; `OfficialCloudWhatsAppApi`.
+
+## WhatsAppPresence
+
+`.../enums/WhatsAppPresence.java`
+
+| Valor | Significado | Efeito / onde é tratado | Observações |
+|---|---|---|---|
+| `UNAVAILABLE` (`unavailable`) | Offline | Enviado como `presence` | Valores fechados pelo `presenceOnlySchema` da Evolution (Javadoc) |
+| `AVAILABLE` (`available`) | Online | idem | |
+| `COMPOSING` (`composing`) | "Digitando…" | idem | Mais útil em `sendPresence` (chat) |
+| `RECORDING` (`recording`) | "Gravando áudio…" | idem | idem |
+| `PAUSED` (`paused`) | Parou de digitar/gravar | idem | idem |
+
+- `getValue()`, `fromValue(String)` (lança se desconhecido). Sem anotações Jackson.
+- Tratado em `EvolutionWhatsAppApi#setPresence` (`Map.of("presence", ...)`) e `#sendPresence` (`presence` + `delay` opcional). `null` → `WhatsAppException("presence is required")`. Não há `switch`: todos os valores seguem o mesmo caminho (**Confirmado**). O módulo cloud não referencia presença (**Inferência**: provider Cloud não a implementa).
+
+## WhatsAppBlockAction
+
+`.../enums/WhatsAppBlockAction.java`
+
+| Valor | Significado | Efeito | Observações |
+|---|---|---|---|
+| `BLOCK` (`block`) | Bloquear contato | `payload.status = "block"` em `updateBlockStatus` | **Confirmado** |
+| `UNBLOCK` (`unblock`) | Desbloquear | `payload.status = "unblock"` | **Confirmado** |
+
+- `getValue()`, `fromValue`. `null` → `"status is required"`. O campo do payload chama-se `status`, não `action`.
+
+## WhatsAppLabelAction
+
+`.../enums/WhatsAppLabelAction.java`
+
+| Valor | Significado | Efeito | Observações |
+|---|---|---|---|
+| `ADD` (`add`) | Aplica etiqueta ao contato | `payload.action = "add"` em `handleLabel` | **Confirmado** |
+| `REMOVE` (`remove`) | Remove etiqueta | `payload.action = "remove"` | **Confirmado** |
+
+- `getValue()`, `fromValue`. `null` → `"action is required"`.
+
+## WhatsAppGroupParticipantAction
+
+`.../enums/WhatsAppGroupParticipantAction.java`
+
+| Valor | Significado | Efeito | Observações |
+|---|---|---|---|
+| `ADD` (`add`) | Adiciona participantes | `payload.action` em `updateParticipants` | **Confirmado** |
+| `REMOVE` (`remove`) | Remove participantes | idem | |
+| `PROMOTE` (`promote`) | Promove a admin | idem | |
+| `DEMOTE` (`demote`) | Rebaixa de admin | idem | |
+
+- `getValue()`, `fromValue`. `null` → `"action is required"`; lista de participantes vazia → `"participants is required"`.
+
+## WhatsAppGroupSetting
+
+`.../enums/WhatsAppGroupSetting.java`
+
+| Valor | Significado | Efeito | Observações |
+|---|---|---|---|
+| `ANNOUNCEMENT` (`announcement`) | Só administradores enviam mensagens | `payload.action` em `updateGroupSetting` | Javadoc |
+| `NOT_ANNOUNCEMENT` (`not_announcement`) | Todos enviam | idem | Javadoc |
+| `LOCKED` (`locked`) | Só administradores editam dados do grupo | idem | Javadoc |
+| `UNLOCKED` (`unlocked`) | Todos editam | idem | Javadoc |
+
+- `getValue()`, `fromValue`. `null` → mensagem `"action is required"`.
+
+## WhatsAppEphemeralExpiration
+
+`.../enums/WhatsAppEphemeralExpiration.java`
+
+| Valor | Significado | Efeito | Observações |
+|---|---|---|---|
+| `OFF` (0) | Desliga mensagens temporárias | `payload.expiration = 0` | |
+| `ONE_DAY` (86 400) | 24 h | `payload.expiration = 86400` | |
+| `SEVEN_DAYS` (604 800) | 7 dias | idem | |
+| `NINETY_DAYS` (7 776 000) | 90 dias | idem | |
+
+- Campo `seconds` (`int`), `getSeconds()`, `static fromSeconds(int)` (lança se não for um dos 4). Único enum com valor **numérico** no payload. Javadoc: a Evolution só aceita estes 4 valores.
+- Tratado em `EvolutionWhatsAppApi#toggleEphemeral`; `null` → `"expiration is required"`.
+
+## WhatsAppPrivacyValue
+
+`.../enums/WhatsAppPrivacyValue.java` · espelha `WAPrivacyValue` do Baileys.
+
+| Valor | Significado | Efeito | Observações |
+|---|---|---|---|
+| `ALL` (`all`) | Todos | Serializado/lido no JSON de `WhatsAppPrivacySettings` | Javadoc |
+| `CONTACTS` (`contacts`) | Apenas contatos | idem | |
+| `CONTACT_BLACKLIST` (`contact_blacklist`) | Contatos, exceto os selecionados | idem | |
+| `NONE` (`none`) | Ninguém | idem | |
+
+- Serialização: `@JsonValue getValue()` e `@JsonCreator fromValue(String)`; o JSON usa o texto (`"contacts"`). Valor desconhecido vindo da Evolution lança `WhatsAppException` na desserialização (`@JsonIgnoreProperties(ignoreUnknown)` cobre propriedades, não valores; **Inferência**).
+- Usado em: `WhatsAppPrivacySettings.profile`, `.status`, `.last`; `fetchPrivacySettings`/`updatePrivacySettings`.
+
+## WhatsAppReadReceiptsValue
+
+| Valor | Significado | Observações |
+|---|---|---|
+| `ALL` (`all`) | Confirmação de leitura ligada | |
+| `NONE` (`none`) | Desligada | `contacts` **não** é aceito aqui |
+
+- `@JsonValue`/`@JsonCreator`. Usado em `WhatsAppPrivacySettings.readreceipts`.
+
+## WhatsAppOnlinePrivacyValue
+
+| Valor | Significado | Observações |
+|---|---|---|
+| `ALL` (`all`) | Todos veem o "online" | |
+| `MATCH_LAST_SEEN` (`match_last_seen`) | Segue a regra do "visto por último" | |
+
+- `@JsonValue`/`@JsonCreator`. Usado em `WhatsAppPrivacySettings.online`.
+
+## WhatsAppGroupAddPrivacyValue
+
+| Valor | Significado | Observações |
+|---|---|---|
+| `ALL` (`all`) | Qualquer um adiciona | |
+| `CONTACTS` (`contacts`) | Só contatos | |
+| `CONTACT_BLACKLIST` (`contact_blacklist`) | Contatos, exceto selecionados | Não existe `none` aqui |
+
+- `@JsonValue`/`@JsonCreator`. Usado em `WhatsAppPrivacySettings.groupadd`.
+
+## Persistência
+
+Nenhum enum é persistido: a extension não tem entidades JPA, `@Enumerated`, converters nem migrations (ver [[SeedGrid/Extensions/whatsapp/Visao-geral|Visão geral]]). Não há CHECK constraints a comparar.
+
+## Notas Rust
+
+Os 12 enums existem no crate Rust (`src/enums.rs`/`src/dtos.rs`) com as mesmas constantes e textos de wire.
+- Nomes em PascalCase (`Official`, `ContactBlacklist`...), mesmos textos.
+- `from_seconds`/`seconds()` usam `i64`.
+- `WhatsAppMediaType`, `WhatsAppPresence` e `WhatsAppEphemeralExpiration` são serializados por serde manual (texto/número do wire).
+- `WhatsAppMediaType` (`None`), os 4 de privacidade (`All`) e `EphemeralExpiration` (`Off`) têm `Default`; `WhatsAppPrivacySettings` usa campos não opcionais com `#[serde(default)]`.
+
+## Internos
+
+Nenhum enum interno ou privado em `src/main`.

package/seedgridKB/SeedGrid/Extensions/whatsapp/Exemplos.md

@@ -0,0 +1,173 @@
+---
+tags: [seedgrid, extension, whatsapp, exemplos]
+fonte: java/seedgrid-quarkus-ext-whatsapp
+branch: main
+commit: d8454f6313
+analisado-em: 2026-10-14
+---
+
+# Exemplos — seedgrid-whatsapp (Quarkus)
+
+Links: [[SeedGrid/Extensions/whatsapp/Visao-geral|Visão geral do whatsapp]] · [[SeedGrid/Extensions/whatsapp/Configuracao|Configuração do whatsapp]]
+
+Assinaturas conferidas no código (`seedgrid-whatsapp-core/src/main/java/br/com/seedgrid/whatsapp/...`). Os métodos de envio retornam `WhatsAppSendMessageResultDTO`.
+
+## 1. Dependências (Maven)
+
+```xml
+<dependency>
+  <groupId>br.com.seedgrid</groupId>
+  <artifactId>seedgrid-whatsapp-core</artifactId>
+  <version>2026.08.16</version>
+</dependency>
+<!-- um (ou os dois) providers -->
+<dependency>
+  <groupId>br.com.seedgrid</groupId>
+  <artifactId>seedgrid-whatsapp-evolution</artifactId>
+  <version>2026.08.16</version>
+</dependency>
+<dependency>
+  <groupId>br.com.seedgrid</groupId>
+  <artifactId>seedgrid-whatsapp-whatsapp-cloud</artifactId>
+  <version>2026.08.16</version>
+</dependency>
+```
+
+Configuração: ver [[SeedGrid/Extensions/whatsapp/Configuracao|Configuração do whatsapp]] (seções 6 e 7).
+
+## 2. Enviar texto pela interface comum (fonte: README + `WhatsAppApi`)
+
+```java
+import br.com.seedgrid.whatsapp.dtos.WhatsAppSendMessageResultDTO;
+import br.com.seedgrid.whatsapp.dtos.WhatsAppTextMessageDTO;
+import br.com.seedgrid.whatsapp.services.WhatsAppApi;
+import jakarta.enterprise.context.ApplicationScoped;
+
+@ApplicationScoped
+public class NotificadorWhatsApp {
+
+    private final WhatsAppApi api; // produzido por WhatsAppApiProducer conforme seedgrid.whatsapp.api
+
+    public NotificadorWhatsApp(WhatsAppApi api) {
+        this.api = api;
+    }
+
+    public String avisar(String canal, String telefone, String texto) {
+        // canal: nome da instância (Evolution) ou PHONE_NUMBER_ID (Cloud)
+        WhatsAppSendMessageResultDTO r =
+                api.sendTextMessage(canal, new WhatsAppTextMessageDTO(telefone, texto));
+        return r.messageId();
+    }
+}
+```
+
+`telefone` aceita formatos BR com 11 dígitos após remover não-dígitos (ex.: `"(11) 99999-9999"`) ou 13 começando com `55`.
+
+## 3. Opções de mensagem (resposta, preview, atraso)
+
+```java
+import br.com.seedgrid.whatsapp.dtos.WhatsAppMessageOptionsDTO;
+import br.com.seedgrid.whatsapp.dtos.WhatsAppTextMessageDTO;
+
+// responder citando uma mensagem
+api.sendTextMessage(canal, new WhatsAppTextMessageDTO(
+        "11999999999", "Recebido!", WhatsAppMessageOptionsDTO.quoting("<id-da-mensagem>")));
+
+// desligar preview de link (na Cloud o padrão de preview_url é true)
+api.sendTextMessage(canal, new WhatsAppTextMessageDTO(
+        "11999999999", "Veja https://exemplo.com", WhatsAppMessageOptionsDTO.linkPreview(false)));
+```
+
+## 4. Mídia, áudio, localização, template
+
+```java
+import br.com.seedgrid.whatsapp.dtos.*;
+import br.com.seedgrid.whatsapp.enums.WhatsAppMediaType;
+import java.util.List;
+
+api.sendMediaUrl(canal, new WhatsAppMediaMessageURLDTO(
+        "11999999999", WhatsAppMediaType.DOCUMENT,
+        "https://exemplo.com/contrato.pdf", "contrato.pdf", "Segue o contrato"));
+
+api.sendMediaFile(canal, new WhatsAppMediaMessageFileDTO(
+        "11999999999", WhatsAppMediaType.IMAGE,
+        "<conteudo-base64>", "foto.jpg", "foto.jpg", "Legenda"));
+
+api.sendAudioUrl(canal, new WhatsAppAudioMessageURLDTO("11999999999", "https://exemplo.com/audio.mp3"));
+api.sendAudioFile(canal, new WhatsAppAudioMessageFileDTO("11999999999", "/caminho/local/audio.ogg")); // lido do disco
+
+api.sendLocation(canal, new WhatsAppLocationMessageDTO(
+        "11999999999", -23.5505, -46.6333, "Escritório", "Av. Exemplo, 100"));
+
+api.sendTemplate(canal, new WhatsAppTemplateMessageDTO(
+        "11999999999", "<nome-do-template>", "pt_BR", List.of()));
+```
+
+## 5. Reação (alvo é a mensagem, não um número)
+
+```java
+api.sendReaction(canal, new WhatsAppReactionMessageDTO(
+        "<id-da-mensagem>", "5511999999999@s.whatsapp.net", false, "👍"));
+```
+
+## 6. Recursos exclusivos da Evolution
+
+Inferência (CDI): o bean `EvolutionWhatsAppApi` tem qualificador `@EvolutionProvider`, então as interfaces específicas são injetadas com esse qualificador.
+
+```java
+import br.com.seedgrid.whatsapp.qualifiers.EvolutionProvider;
+import br.com.seedgrid.whatsapp.services.*;
+import br.com.seedgrid.whatsapp.dtos.WhatsAppPollMessageDTO;
+import br.com.seedgrid.whatsapp.enums.WhatsAppPresence;
+import jakarta.inject.Inject;
+import java.util.List;
+
+@Inject @EvolutionProvider WhatsAppInstanceManagementApi instancias;
+@Inject @EvolutionProvider WhatsAppEvolutionMessagingApi mensagensEvolution;
+@Inject @EvolutionProvider WhatsAppChatApi chat;
+@Inject @EvolutionProvider WhatsAppGroupApi grupos;
+
+void exemplo() {
+    String instanceId = instancias.createInstance("cliente-abc");
+    String qrBase64 = instancias.connectInstance("cliente-abc");   // PNG em base64 sem prefixo data:
+    String estado = instancias.getConnectionState("cliente-abc");
+
+    // webhook (fonte: README)
+    WebhookConfig cfg = new WebhookConfig();
+    cfg.enabled = true;
+    cfg.url = "https://meu-servidor.example/webhook";
+    cfg.byEvents = true;
+    cfg.base64 = false;
+    cfg.events = List.of("MESSAGES_UPSERT", "MESSAGES_UPDATE", "CONNECTION_UPDATE");
+    instancias.setWebHook("cliente-abc", cfg);
+
+    mensagensEvolution.sendPoll("cliente-abc", new WhatsAppPollMessageDTO(
+            "11999999999", "Melhor horário?", 1, List.of("Manhã", "Tarde")));
+
+    List<WhatsAppNumberCheck> existentes = chat.whatsappNumbers("cliente-abc", List.of("11999999999"));
+    chat.sendPresence("cliente-abc", "11999999999", WhatsAppPresence.COMPOSING, 1500);
+    Object contatos = chat.findContacts("cliente-abc", WhatsAppQuery.all());
+
+    WhatsAppGroup g = grupos.createGroup("cliente-abc", "Equipe", List.of("11999999999"), "Grupo da equipe", false);
+}
+```
+
+## 7. Tratamento de erros
+
+```java
+import br.com.seedgrid.whatsapp.exceptions.WhatsAppException;
+
+try {
+    api.sendTextMessage(canal, new WhatsAppTextMessageDTO("123", "Teste"));
+} catch (WhatsAppException e) {
+    // número inválido, channelId vazio, falha lendo arquivo...
+    // em endpoints REST, o seedgrid-commons converte para HTTP 422 (WhatsAppExceptionExtension)
+} catch (IllegalStateException e) {
+    // credencial do provider ausente (api-key / access-token)
+}
+```
+
+## 8. Testes como referência
+
+- `seedgrid-whatsapp-evolution/src/test/java/br/com/seedgrid/whatsapp/services/EvolutionWhatsAppApiTest.java` — payloads esperados para cada operação (Mockito sobre `EvolutionRestClient`).
+- `seedgrid-whatsapp-whatsapp-cloud/src/test/java/br/com/seedgrid/whatsapp/services/OfficialCloudWhatsAppApiTest.java` — payloads da Graph API e upload multipart.

package/seedgridKB/SeedGrid/Extensions/whatsapp/Rust.md

@@ -0,0 +1,83 @@
+---
+tags: [seedgrid, extension, whatsapp, rust]
+fonte: rust/seedgrid-rust-crate-whatsapp
+branch: main
+commit: be738a2d1e
+analisado-em: 2026-10-14
+---
+
+# whatsapp — porte Rust (`seedgrid-rust-crate-whatsapp`)
+
+Porte da extensão Quarkus `seedgrid-quarkus-ext-whatsapp`. Lado Java: [[SeedGrid/Extensions/whatsapp/Visao-geral|Visão geral do whatsapp (Java)]] · [[SeedGrid/Extensions/whatsapp/Configuracao|Configuração do whatsapp (Java)]]. Configuração Rust: [[SeedGrid/Extensions/whatsapp/Configuracao-Rust|Configuração Rust do whatsapp]].
+
+Biblioteca **só de saída** (sem webhooks de entrada) para enviar mensagens WhatsApp por vários provedores, escolhidos por configuração. **Confirmado** (`src/lib.rs`).
+
+| Provider (`seedgrid.whatsapp.api`) | Implementação | Capacidades |
+|---|---|---|
+| `default` (ou vazio/desconhecido) | `DefaultWhatsAppApi` | no-op: só loga WARNING; `is_configured()` sempre `false` |
+| `evolution` | `EvolutionWhatsAppApi` | Evolution API (Baileys): envio + mensagens Evolution + grupos, chat, labels, gestão de instâncias |
+| `whatsapp-cloud` | `OfficialCloudWhatsAppApi` | WhatsApp Cloud oficial (Meta Graph API): só envio |
+
+## Identificação
+| Item | Valor |
+|---|---|
+| Pacote Cargo | `seedgrid-rust-crate-whatsapp` (lib `seedgrid_whatsapp`) |
+| Versão | workspace `2026.10.14` |
+| Features | nenhuma (todos os providers sempre compilados) |
+| Dependências SeedGrid | nenhuma |
+| Consumidor | security (2FA por WhatsApp: `rust/seedgrid-rust-crate-security/src/state.rs` chama `WhatsAppConfig::from_env()`) |
+
+## API pública
+| Símbolo | Papel | Fonte |
+|---|---|---|
+| `WhatsAppConfig` (`from_env`, `Default`), `DEFAULT_CLOUD_URL` | config | `src/config.rs` |
+| `create_whatsapp_api(&WhatsAppConfig) -> Arc<dyn WhatsAppApi>` | fábrica por provider (`WhatsAppProvider::from_config`: `trim` + minúsculas) | `src/factory.rs`, `src/enums.rs` |
+| trait `WhatsAppApi` | `send_text_message`, `send_media_file/url`, `send_audio_file/url`, `send_location`, `send_contact`, `send_reaction`, `send_sticker`, `send_template`…, `provider()`, `is_configured()` | `src/api.rs` |
+| traits `WhatsAppEvolutionMessaging` (`send_ptv`, `send_poll`, `send_list`, `send_buttons`, `send_status`, `offer_call`), `WhatsAppLabels`, `WhatsAppGroups`, `WhatsAppChat`, `WhatsAppInstanceManagement` (`create_instance`, `delete_instance`, `get_instances`, `connect_instance`, `get_connection_state`, `restart_instance`, `set_webhook`, `get_webhook`) | capacidades Evolution | `src/api.rs` |
+| DTOs (`WhatsAppTextMessage`, `WhatsAppMedia*`, `WhatsAppSendMessageResult`, `WhatsAppInstance`, `WebhookConfig`…) e enums | modelo | `src/dtos.rs`, `src/enums.rs` |
+| `WhatsAppError` (`IllegalState` quando falta credencial), `Result` | erros | `src/error.rs` |
+
+As credenciais não são validadas na construção: a falta de `api-key`/`access-token` vira `WhatsAppError::IllegalState` na primeira chamada que precisa dela (`require_api_key` em `src/evolution.rs`; header Bearer em `src/cloud.rs`), como no Java.
+
+## Exemplo (doc de `src/lib.rs`)
+```rust
+use seedgrid_whatsapp::{WhatsAppConfig, create_whatsapp_api, WhatsAppTextMessage};
+
+let config = WhatsAppConfig::from_env();
+let api = create_whatsapp_api(&config);
+let res = api
+    .send_text_message("meu-channel-id", WhatsAppTextMessage::new("11999999999", "Seu codigo: 1234"))
+    .await?;
+println!("message_id = {}", res.message_id);
+```
+Não há app em `rust/examples/` para whatsapp.
+
+## Testes
+Unitários extensos em `src/evolution.rs`, `src/cloud.rs`, `src/factory.rs`; `tests/http_integration_test.rs` (servidor falso `wiremock`, valida path/header/corpo). **Não executados.**
+
+## Notas de comportamento
+
+- `WhatsAppExceptionExtension` (HTTP 422) não existe; o host mapeia os erros.
+- O trait tem `provider()` e `is_configured()` extras.
+- A fábrica não tem fallback `isResolvable`.
+
+## Enums
+Java: [[SeedGrid/Extensions/whatsapp/Enums|Enums do whatsapp (Java)]]. Todos em `src/enums.rs`; cada um tem `value()` (texto) e `from_value()` (erro `WhatsAppError::WhatsApp("Unexpected value '…'")` se desconhecido) e `Serialize`/`Deserialize` manuais pelo texto (como o `@JsonValue`/`@JsonCreator` do Java). Variantes e textos **iguais** aos do Java.
+
+| Enum | Variantes → texto | Java equivalente |
+|---|---|---|
+| `WhatsAppProvider` | `Default` → `default`, `Evolution` → `evolution`, `Official` → `whatsapp-cloud` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppProvider\|WhatsAppProvider]] |
+| `WhatsAppMediaType` | `None`, `Image`, `Video`, `Audio`, `Document` → minúsculas | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppMediaType\|WhatsAppMediaType]] |
+| `WhatsAppPresence` | `Unavailable`, `Available`, `Composing`, `Recording`, `Paused` → minúsculas | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppPresence\|WhatsAppPresence]] |
+| `WhatsAppLabelAction` | `Add`, `Remove` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppLabelAction\|WhatsAppLabelAction]] |
+| `WhatsAppGroupParticipantAction` | `Add`, `Remove`, `Promote`, `Demote` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppGroupParticipantAction\|WhatsAppGroupParticipantAction]] |
+| `WhatsAppGroupSetting` | `Announcement`, `NotAnnouncement` → `not_announcement`, `Locked`, `Unlocked` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppGroupSetting\|WhatsAppGroupSetting]] |
+| `WhatsAppEphemeralExpiration` | `Off` 0, `OneDay` 86400, `SevenDays` 604800, `NinetyDays` 7776000 (segundos, sem texto) | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppEphemeralExpiration\|WhatsAppEphemeralExpiration]] |
+| `WhatsAppBlockAction` | `Block`, `Unblock` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppBlockAction\|WhatsAppBlockAction]] |
+| `WhatsAppPrivacyValue` | `All`, `Contacts`, `ContactBlacklist` → `contact_blacklist`, `None` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppPrivacyValue\|WhatsAppPrivacyValue]] |
+| `WhatsAppReadReceiptsValue` | `All`, `None` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppReadReceiptsValue\|WhatsAppReadReceiptsValue]] |
+| `WhatsAppOnlinePrivacyValue` | `All`, `MatchLastSeen` → `match_last_seen` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppOnlinePrivacyValue\|WhatsAppOnlinePrivacyValue]] |
+| `WhatsAppGroupAddPrivacyValue` | `All`, `Contacts`, `ContactBlacklist` | [[SeedGrid/Extensions/whatsapp/Enums#WhatsAppGroupAddPrivacyValue\|WhatsAppGroupAddPrivacyValue]] |
+| `WhatsAppError` | `WhatsApp`, `IllegalState` (credencial ausente), `Unsupported` | exceções do módulo |
+
+`WhatsAppProvider::from_config` (config `seedgrid.whatsapp.api`): vazio, `default` ou valor desconhecido → `Default`; trim + minúsculas; `evolution` → `Evolution`; `whatsapp-cloud` → `Official` ([[SeedGrid/Extensions/whatsapp/Configuracao-Rust|Configuração Rust]]).