Pular para o conteúdo
Atalho: /, ⌘K ou Ctrl+K

Perfil comercial

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

Ver em Markdown

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. 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 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 modoEntrada aceita
Atualização do perfilÉ obrigatório enviar pelo menos um campo de perfil compatível. Uma atualização vazia é rejeitada.
hours.daysInclua cada dia da semana no máximo uma vez.
specific_hoursopenTime 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_onlyOmita openTime e closeTime.
websites[]Use uma URL HTTP ou HTTPS absoluta.
Foto de capaDefina 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 e Delete business cover photo para a mídia de capa.

Contas vinculadas e elegibilidade#

Get business linked accounts lê as identidades vinculadas do Facebook, do Instagram, de publicidade e de catálogo quando o WhatsApp as retorna.

Get business eligibility 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 lê a pessoa jurídica e os contatos de atendimento ao cliente da conta conectada. Update merchant compliance 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:

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"]
  }'

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.