Números

Tus números de WhatsApp, oficiales de Meta o por QR, con la misma API. Recomendamos el oficial (por qué).

Los dos tipos de númeroCopiar el enlace a esta sección

La llamada es la misma para los dos. Qué puede hacer cada número en concreto lo dice su ficha: abajo.

Lo que podés hacer hoyCopiar el enlace a esta sección

• Listar números: tus números con su proveedor (provider), si están conectados y activos, su salud y qué puede hacer cada uno (capabilities). Te da el device_id que piden las demás llamadas, por ejemplo para enviar. is_coexistence dice si el número está en coexistencia (el mismo teléfono en WhatsApp Cloud y en la app WhatsApp Business del celular).
• Ver el estado de conexión y la salud de un número.
• Reiniciar la sesión o limpiarla: después hay que volver a escanear el QR. Son irreversibles y piden accounts:operate.
• Eliminar un número.

Cuando un número se conecta o se desconecta, te llegan device.connected y device.disconnected (catálogo). Un número oficial todavía no emite device.disconnected.

El número oficial se conecta una vez desde el panel de Funnelchat.

Qué puede hacer cada númeroCopiar el enlace a esta sección

La ficha de cada número (Listar números y Ver un número) trae capabilities: lo que la API puede hacer con ese número, según su proveedor. Miralo antes de mandar, en lugar de suponerlo por el tipo de número.

{
  "capabilities": {
    "messages": { "text": true, "media": true, "buttons": true, "lists": true, "templates": true,
                  "location": false, "voice_note": false, "polls": false, "events": false,
                  "contact_card": true, "reactions": true },
    "groups": { "create": true, "add_participants": "invite", "remove_participants": true,
                "admins": false, "photo": false, "settings": false, "invite_link": true, "send": true,
                "join_requests": "list_and_decide" },
    "statuses": ["sent", "delivered", "read", "failed"]
  }
}

• messages: un verdadero o falso por tipo de mensaje. location, voice_note, polls y events figuran, pero hoy la API no tiene una ruta para mandarlos (Mensajes).
• groups: qué puede hacer con sus grupos. add_participants vale "direct" (agrega a la gente directo) o "invite" (la invita); join_requests, "list" (ve las solicitudes para unirse) o "list_and_decide" (además, las aprueba o rechaza).
• statuses: los estados de mensaje que informa (Estados de mensaje).

Los valores del ejemplo son ilustrativos: los de cada número salen de su ficha.

Probalo acáCopiar el enlace a esta sección

Tus números, con tu clave. Es una lectura: no cambia nada.

curl -X GET "https://example.com/devices"

[  {    "id": 0,    "alias": "string",    "image": "string",    "color": "string",    "number": "string",    "normalized_number": "string",    "first_conecction_at": "string",    "user_id": 0,    "provider": 1,    "waba_id": "string",    "whatsapp_username": "string",    "is_business": 0,    "connected": 0,    "active": 0,    "health": "string",    "number_key": "string",    "number_key_confirmed": "string",    "is_coexistence": true,    "slot_state": "string",    "pool_suspended": true,    "pool_suspension_reason": "string",    "pool_keep": true,    "qr_allowed": true,    "can_change_to_meta": true,    "capabilities": {      "messages": {        "text": true,        "media": true,        "buttons": true,        "lists": true,        "templates": true,        "location": true,        "voice_note": true,        "polls": true,        "events": true,        "contact_card": true,        "reactions": true      },      "groups": {        "create": true,        "add_participants": true,        "remove_participants": true,        "admins": true,        "photo": true,        "settings": true,        "invite_link": true,        "send": true,        "join_requests": true      },      "statuses": [        "string"      ]    }  }]