# Perfil comercial

> Gerencie a identidade comercial, contas vinculadas, elegibilidade, mídia de capa e dados de conformidade.

Os métodos de perfil do Business App vinculado leem e alteram a conta
conectada. Os métodos de perfil comercial da Graph retornam os campos de perfil
salvos para números com Dispositivos vinculados e números simulados. Eles não
leem nem alteram o perfil do WhatsApp de um número real da Cloud API.

## Perfil do Business App vinculado

Comece por [Get own business profile](https://docs.polymorfa.com/api/business-profiles/get-own-business-profile?playground=open). A resposta pode incluir descrição, endereço, e-mail, sites, horário de funcionamento, categorias, ID da foto de capa e as opções de perfil retornadas pelo WhatsApp.

[Update linked business profile](https://docs.polymorfa.com/api/business-profiles/update-linked-business-profile?playground=open) altera apenas os campos enviados. Valores vazios limpam os campos opcionais compatíveis. O horário de funcionamento usa fuso horário, dia da semana, modo e minutos após a meia-noite.

### Regras da solicitação de perfil

| Campos ou modo | Entrada aceita |
| --- | --- |
| Atualização do perfil | É obrigatório enviar pelo menos um campo de perfil compatível. Uma atualização vazia é rejeitada. |
| `hours.days` | Inclua cada dia da semana no máximo uma vez. |
| `specific_hours` | `openTime` e `closeTime` são obrigatórios e precisam ser diferentes. Cada um é um número inteiro de 0 a 1439 minutos após a meia-noite. |
| `open_24h` ou `appointment_only` | Omita `openTime` e `closeTime`. |
| `websites[]` | Use uma URL HTTP ou HTTPS absoluta. |
| Foto de capa | Defina exatamente um entre `url` e `base64`. Uma solicitação vazia ou com as duas origens juntas é rejeitada. A imagem decodificada ou baixada aceita no máximo 5 MiB. |

Use [Set business cover photo](https://docs.polymorfa.com/api/business-profiles/set-business-cover-photo?playground=open) e [Delete business cover photo](https://docs.polymorfa.com/api/business-profiles/delete-business-cover-photo?playground=open) para a mídia de capa.

## Contas vinculadas e elegibilidade

[Get business linked accounts](https://docs.polymorfa.com/api/business-profiles/get-business-linked-accounts?playground=open) lê as identidades vinculadas do Facebook, do Instagram, de publicidade e de catálogo quando o WhatsApp as retorna.

[Get business eligibility](https://docs.polymorfa.com/api/business-profiles/get-business-eligibility?playground=open) informa a elegibilidade da conta no provedor. Ele não concede um direito de uso da Polymorfa.

Os dois métodos fazem consultas em tempo real. Eles não ativam o acompanhamento do perfil em segundo plano.

## Conformidade do comerciante

[Get merchant compliance](https://docs.polymorfa.com/api/business-profiles/get-business-merchant-compliance?playground=open) lê a pessoa jurídica e os contatos de atendimento ao cliente da conta conectada. [Update merchant compliance](https://docs.polymorfa.com/api/business-profiles/set-business-merchant-compliance?playground=open) substitui o registro completo.

Os textos de conformidade têm os espaços das extremidades removidos antes da
validação. Nomes de entidade, tipos de entidade personalizados e nomes do
responsável por reclamações aceitam no máximo 256 bytes UTF-8; o e-mail aceita
no máximo 254 bytes UTF-8; telefones fixos e celulares aceitam no máximo 64
bytes UTF-8 cada.

O WhatsApp controla se uma conta e uma região podem editar esses dados. Uma rejeição do provedor mantém o registro existente sem alterações.

## Perfis comerciais pela Graph API

A Graph API lê e salva os campos do perfil comercial no formato da Meta:

```bash Graph API
curl "https://api.polymorfa.com/graph/whatsapp/v26.0/$PHONE_NUMBER_ID/whatsapp_business_profile" \
  -H "Authorization: Bearer $POLYMORFA_PROJECT_TOKEN"

curl -X POST "https://api.polymorfa.com/graph/whatsapp/v26.0/$PHONE_NUMBER_ID/whatsapp_business_profile" \
  -H "Authorization: Bearer $POLYMORFA_PROJECT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "about": "Orders ship within two days",
    "websites": ["https://shop.example.com"]
  }'
```

**Graph API:** Números da Meta Cloud API: Não compatível. Números com Dispositivos vinculados: Compatível.

Para um número com Dispositivos vinculados ou um número simulado,
[Get business profile](https://docs.polymorfa.com/api/graph/business-profiles/get-business-profile?playground=open)
retorna os campos salvos e
[Update saved business profile](https://docs.polymorfa.com/api/graph/business-profiles/update-saved-business-profile?playground=open)
os altera. Um número real da Meta Cloud API recebe o erro de capacidade
`131026` dos dois métodos; a solicitação não lê nem altera o perfil dele no
WhatsApp.

A leitura exige `sessions:read` e a atualização exige `sessions:manage`. Esses
métodos armazenam os campos do formato de perfil comercial da Meta (`about`,
`address`, `description`, `email`, `websites`, `vertical` e um identificador de
foto de perfil). Horário de funcionamento, fotos de capa, contas vinculadas e
conformidade do comerciante não têm método na Graph; use os métodos acima.

As páginas dos métodos contêm o esquema da solicitação, as respostas, os escopos, os selos de conexão e o playground de solicitações brutas.
