Administrar números de teléfono de WhatsApp

​

Qué es

​

Antes de empezar

• Conecta la WABA principal a YCloud.
• Añade el número de teléfono a la WABA.
• Guarda el ID de la WABA y el número de teléfono en formato E.164.
• Sube una foto de perfil a Meta antes de configurar profilePictureUrl.

​

Cómo funciona

1. Enumera los números o recupera un número para inspeccionar su estado.
2. Registra un número antes de usarlo para enviar mensajes.
3. Actualiza el perfil de empresa de cara al cliente.
4. Actualiza el nombre visible, la visibilidad comercial o la configuración de llamadas según sea necesario.
5. Recupera el recurso nuevamente para confirmar la configuración actual.

​

Solicitud

​

Registrar un número de teléfono

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

​

Actualizar el perfil de empresa

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

​

Actualizar la visibilidad comercial

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

​

Respuesta

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

​

Áreas de configuración

​

Límites y solución de problemas

• Los campos del perfil tienen límites de formato y longitud; consulte la Referencia de la API para conocer las restricciones completas.
• Las URL del sitio web deben incluir http:// o https://.
• Es posible que la actualización del nombre visible no se active de inmediato.
• El registro, la calidad y el estado de la WABA pueden afectar el envío de forma independiente.
• Utilice el ID de la WABA y el número E.164 exacto en cada ruta.