Gerenciar números de telefone do WhatsApp

​

O que é

​

Antes de começar

• Conecte a WABA pai à YCloud.
• Adicione o número de telefone à WABA.
• Armazene o ID da WABA e o número de telefone no formato E.164.
• Envie uma foto de perfil à Meta antes de definir profilePictureUrl.

​

Como funciona

1. Liste os números ou recupere um número para inspecionar seu estado.
2. Registre um número antes de usá-lo para envio de mensagens.
3. Atualize o perfil comercial voltado ao cliente.
4. Atualize o nome de exibição, a visibilidade de comércio ou as configurações de chamadas conforme necessário.
5. Recupere o recurso novamente para confirmar a configuração atual.

​

Requisição

​

Registrar um número de telefone

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/register \
  --header "X-API-Key: $YCLOUD_API_KEY"

​

Atualizar o perfil comercial

curl --request PATCH \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/profile \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "about": "Customer support and order updates",
    "address": "100 Market Street",
    "description": "Example Store",
    "email": "support@example.com",
    "vertical": "RETAIL",
    "websites": ["https://example.com"]
  }'

​

Atualizar a visibilidade do comércio

curl --request PATCH \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/whatsappCommerceSettings \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "isCartEnabled": true,
    "isCatalogVisible": true
  }'

​

Resposta

{
  "about": "Customer support and order updates",
  "email": "support@example.com",
  "vertical": "RETAIL",
  "websites": ["https://example.com"]
}

​

Áreas de configuração

​

Limites e solução de problemas

• Os campos do perfil têm limites de formato e tamanho; consulte a Referência da API para as restrições completas.
• URLs de site devem incluir http:// ou https://.
• Uma atualização de nome de exibição pode não entrar em vigor imediatamente.
• Registro, qualidade e estado da WABA podem afetar o envio de forma independente.
• Use o ID da WABA e o número E.164 exato em cada caminho.