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. 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 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 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:
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.