Usar identificadores de usuario con ámbito empresarial

​

Por qué existen los BSUID

​

Comprender los identificadores

• Un BSUID es único para un par de portafolio comercial y usuario.
• El BSUID de un usuario cambia cuando el usuario cambia su número de teléfono.
• Un BSUID principal funciona en todos los portafolios vinculados para los que Meta lo haya habilitado.
• Un número de teléfono comercial no puede usar un BSUID regular asignado a otro portafolio.

​

Antes de comenzar

• Almacena tu clave de API de YCloud en YCLOUD_API_KEY.
• Usa un número de teléfono comercial de WhatsApp propiedad del mismo portafolio que el BSUID regular.
• Suscribe tu punto de conexión de webhook a los eventos de WhatsApp que utilice tu integración.
• Trata cada nuevo campo de BSUID, BSUID principal, número de teléfono y nombre de usuario como opcional al deserializar webhooks.
• Almacena el BSUID regular y el BSUID principal de forma independiente cuando ambos estén presentes.

​

Enviar un mensaje con un BSUID

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/messages/sendDirectly \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "from": "+16315551111",
    "recipient": "US.13491208655302741918",
    "type": "text",
    "text": {
      "body": "Hello from YCloud!"
    }
  }'

​

Solicitar el número de teléfono de un usuario

​

Usar un botón de plantilla

{
  "type": "buttons",
  "buttons": [
    {
      "type": "REQUEST_CONTACT_INFO",
      "text": "Share Contact Info"
    }
  ]
}

​

Usar un mensaje interactivo

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/messages/sendDirectly \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "from": "+16315551111",
    "recipient": "US.13491208655302741918",
    "type": "interactive",
    "interactive": {
      "type": "request_contact_info",
      "body": {
        "text": "Please share your phone number."
      },
      "action": {
        "name": "request_contact_info"
      }
    }
  }'

​

Gestionar la respuesta del contacto

{
  "type": "whatsapp.inbound_message.received",
  "whatsappInboundMessage": {
    "fromUserId": "US.13491208655302741918",
    "type": "contacts",
    "contacts": [
      {
        "origin": "contact_request",
        "phones": [
          {
            "phone": "+16315551111",
            "wa_id": "16315551111"
          }
        ]
      }
    ]
  }
}

​

Entender la libreta de contactos de Meta

​

Solicitudes de contacto y almacenamiento local

​

Eliminar una entrada de la libreta de contactos de Meta

curl --request DELETE \
  "https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/%2B16315551111/contactBook/US.13491208655302741918" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Accept: application/json"

​

Iniciar una llamada con un BSUID

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/calls/connect \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "from": "+16315551111",
    "recipient": "US.13491208655302741918",
    "sdpType": "offer",
    "sdp": "SDP_OFFER"
  }'

​

Procesar los campos de webhook de BSUID

• El campo de BSUID principal no aparece cuando los BSUID principales no están habilitados.
• El campo del destino de un mensaje o llamada enviados puede estar ausente si te dirigiste al usuario por número de teléfono.
• customerProfile aparece en las actualizaciones de mensajes sent, delivered y read, pero no en las actualizaciones de failed.
• customerProfile.username no está presente si el usuario no ha habilitado los nombres de usuario. También está ausente de las actualizaciones de estado sent.
• Un número de teléfono puede estar ausente incluso cuando el BSUID correspondiente está presente.

​

Gestionar el cambio de número de teléfono de un usuario

{
  "type": "system",
  "system": {
    "type": "user_changed_number",
    "wa_id": "16315552222",
    "user_id": "US.13491208655302741919",
    "parent_user_id": "US.ENT.11815799212886844831"
  }
}

​

Nombres de usuario de la empresa

​

Nombres de usuario reservados

​

Prioridad de visualización en la ventana de chat

1. El nombre guardado en los contactos del cliente.
2. El nombre comercial verificado o el nombre de la cuenta oficial de empresa.
3. El nombre de usuario de la empresa.
4. El número de teléfono.

​

Lista de verificación de migración

1. Agregue cada campo de Webhook relacionado con BSUID a su modelo de deserialización como un campo opcional.
2. Almacene los BSUID normales y principales por separado de los números de teléfono y los nombres de usuario.
3. Indexe la identidad del cliente por portafolio y BSUID. No trate un BSUID como un identificador portátil globalmente.
4. Enrute las solicitudes de mensajes y llamadas a través de to o recipient, y pruebe la regla de precedencia to.
5. Pruebe usuarios solo con nombre de usuario, números de teléfono faltantes, cambios de número de teléfono, BSUID principales faltantes, webhooks duplicados y recreación de la libreta de contactos.