{"id":3043,"date":"2026-10-30T11:43:33","date_gmt":"2026-10-30T11:43:33","guid":{"rendered":"https:\/\/360dialog.com\/blog\/?p=3043"},"modified":"2026-11-06T09:39:18","modified_gmt":"2026-11-06T09:39:18","slug":"sandbox-api-whatsapp-como-probar","status":"publish","type":"post","link":"https:\/\/360dialog.com\/blog\/es\/sandbox-api-whatsapp-como-probar\/","title":{"rendered":"Sandbox de la API de WhatsApp: c\u00f3mo probar la API antes de registrar un n\u00famero"},"content":{"rendered":"\n

Para probar la API de WhatsApp antes de registrar un n\u00famero, pide una clave de API del sandbox por WhatsApp, conecta un webhook HTTPS y env\u00eda mensajes y plantillas a tu propio celular.<\/strong> El sandbox es gratuito y est\u00e1 disponible de inmediato.[9] Un desarrollador puede empezar a construir la integraci\u00f3n el mismo d\u00eda, sin n\u00famero de empresa, sin aprobaci\u00f3n de cuenta y sin llamada de ventas. Cada prueba se hace en el celular del propio desarrollador y nunca llega a clientes reales. Cuando la empresa est\u00e1 lista para pasar a producci\u00f3n, el c\u00f3digo probado se traslada con una nueva direcci\u00f3n de servidor, una nueva clave de API y un nuevo webhook.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Puntos clave<\/h2>\n\n\n\n
    \n
  1. La clave de API del sandbox llega como respuesta de WhatsApp a un solo mensaje START, sin n\u00famero registrado ni llamada de ventas.<\/li>\n\n\n\n
  2. Cada clave del sandbox cubre hasta 200 mensajes, incluidas las solicitudes rechazadas, todos enviados a un \u00fanico destinatario fijo: el WhatsApp de quien hace las pruebas.<\/li>\n\n\n\n
  3. El sandbox comprueba la autenticaci\u00f3n del c\u00f3digo, los eventos entrantes del webhook y la estructura de las solicitudes de mensajes y plantillas.<\/li>\n\n\n\n
  4. Las pruebas que necesitan las reglas de un n\u00famero de empresa est\u00e1ndar van en un n\u00famero 555 proporcionado por Meta, que se factura a tarifas est\u00e1ndar como cualquier n\u00famero normal.<\/li>\n\n\n\n
  5. 360Dialog, Official Meta Solution Partner, ofrece el sandbox y el acceso de producci\u00f3n a la WhatsApp Business API.<\/strong><\/li>\n<\/ol>\n\n\n\n

    <\/p>\n\n\n\n

    \u00bfQu\u00e9 es el sandbox de la API de WhatsApp?<\/h2>\n\n\n\n

    El sandbox de la API de WhatsApp es un entorno de pruebas de 360Dialog que env\u00eda mensajes de formato libre y plantillas a un \u00fanico destinatario fijo: la cuenta de WhatsApp de quien hace las pruebas.[1] Un desarrollador lo usa para comprobar la ruta del c\u00f3digo: el encabezado de autenticaci\u00f3n, el webhook y la estructura de la carga \u00fatil. Cada cuenta de prueba recibe su propia clave de API, vinculada a ese \u00fanico destinatario.<\/p>\n\n\n\n

    Ese destinatario es el n\u00famero de tel\u00e9fono de quien hace las pruebas, incluso una l\u00ednea fija que use WhatsApp. Si esa persona no comparte el n\u00famero, el destinatario es un ID de usuario a nivel de empresa (\u201cBusiness-Scoped User ID\u201d, BSUID). En el celular de prueba, quien prueba hace el papel del cliente: env\u00eda mensajes al sandbox y recibe las respuestas.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    \u00bfC\u00f3mo obtienes una clave de API del sandbox?<\/h2>\n\n\n\n

    Env\u00eda la palabra START desde WhatsApp al n\u00famero del sandbox de 360Dialog y la clave de API del sandbox llega como respuesta. Un mensaje desde el celular de prueba es toda la solicitud. A partir de ah\u00ed, cada llamada a la API del sandbox lleva esa clave en su encabezado.<\/p>\n\n\n\n

    El n\u00famero del sandbox est\u00e1 en la p\u00e1gina Sandbox de nuestra documentaci\u00f3n<\/a>, junto con un enlace de clic para chatear y un c\u00f3digo QR. START debe ir en may\u00fasculas. WhatsApp puede pedirle a quien prueba que comparta su informaci\u00f3n de contacto. Si no la comparte o responde tarde, la clave llega igual en un plazo de 5 minutos, junto con un BSUID.<\/p>\n\n\n\n

    Esa cuenta no tiene ning\u00fan n\u00famero de tel\u00e9fono asociado. Cada solicitud desde ella lleva el BSUID en el campo recipient<\/code> y omite to<\/code>. Comprobar qu\u00e9 identificador usa la clave ahorra una ronda de errores HTTP 403.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    \u00bfC\u00f3mo configuras el webhook del sandbox?<\/h2>\n\n\n\n

    El webhook del sandbox es la direcci\u00f3n HTTPS donde el c\u00f3digo recibe los mensajes entrantes de quien prueba y una actualizaci\u00f3n de estado por cada mensaje que env\u00eda la API. Una sola llamada a la API lo registra. Con el webhook configurado primero, cada prueba posterior aparece como un evento que el c\u00f3digo puede procesar.<\/p>\n\n\n\n

    Registra la direcci\u00f3n en el servidor del sandbox con la clave en el encabezado:<\/p>\n\n\n\n

    curl -X POST https:\/\/waba-sandbox.360dialog.io\/v1\/configs\/webhook \\\n  -H 'Content-Type: application\/json' \\\n  -H 'D360-API-KEY: <YOUR_API_KEY>' \\\n  -d '{\"url\": \"<YOUR_HTTPS_WEBHOOK_URL>\"}'<\/code><\/pre>\n\n\n\n
    Una llamada correcta devuelve HTTP 200 con la URL. Una direcci\u00f3n http simple falla con HTTP 400 y el mensaje \u00aburl must be HTTPS\u00bb. Para pruebas r\u00e1pidas, webhook.site y RequestBin entregan direcciones HTTPS temporales, y ngrok abre un t\u00fanel hacia un puerto local. La misma llamada cambia la direcci\u00f3n del webhook en cualquier momento.<\/p>\n\n\n\n
    Para confirmar que el webhook funciona, vuelve a escribir al n\u00famero del sandbox desde el celular de prueba. Un evento entrante llega en entry[].changes[].value<\/code>, y los estados enviado, entregado y le\u00eddo siguen a cada mensaje saliente. Las cuentas con n\u00famero de tel\u00e9fono reciben wa_id<\/code>, from<\/code> y recipient_id<\/code>. Las cuentas con BSUID reciben user_id<\/code>, from_user_id<\/code> y recipient_user_id<\/code> en su lugar.<\/p>\n\n\n\n
    <\/p>\n\n\n\n
    \u00bfC\u00f3mo env\u00edas tu primer mensaje y tu primera plantilla?<\/h2>\n\n\n\n
    Env\u00eda un texto corto por la API al WhatsApp de quien prueba y luego env\u00eda una plantilla con la misma llamada. Un texto y una plantilla entregados confirman que la autenticaci\u00f3n, el formato de la solicitud y los eventos de estado funcionan de principio a fin.<\/p>\n\n\n\n
    El texto va a \/v1\/messages<\/code> en el servidor del sandbox con los mismos dos encabezados:<\/p>\n\n\n\n
    {\n  \"messaging_product\": \"whatsapp\",\n  \"recipient_type\": \"individual\",\n  \"to\": \"<YOUR_PHONE_NUMBER>\",\n  \"type\": \"text\",\n  \"text\": { \"body\": \"Hello from the sandbox\" }\n}<\/code><\/pre>\n\n\n\n
    Cada solicitud necesita el campo messaging_product<\/code>. El valor de to<\/code> debe coincidir exactamente con el n\u00famero al que est\u00e1 vinculada la clave, y las cuentas con BSUID env\u00edan \"recipient\": \"<YOUR_BUSINESS_SCOPED_USER_ID>\"<\/code> en su lugar. Cualquier otro valor, o la falta de ambos campos, devuelve HTTP 403. Una solicitud v\u00e1lida devuelve HTTP 201 con un ID de mensaje.<\/p>\n\n\n\n
    El sandbox ofrece tres plantillas fijas:<\/p>\n\n\n\n
    Plantilla<\/th>Qu\u00e9 te permite probar<\/th><\/tr><\/thead>
    disclaimer<\/code><\/td>Un mensaje de texto fijo sin par\u00e1metros y con un arreglo components<\/code> vac\u00edo<\/td><\/tr>
    first_welcome_messsage<\/code><\/td>Un par\u00e1metro del cuerpo que personaliza el nombre del destinatario<\/td><\/tr>
    interactive_template_sandbox<\/code><\/td>Una plantilla con dos botones<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    <\/p>\n\n\n\n
    Una solicitud de plantilla indica \"type\": \"template\"<\/code>, el nombre de la plantilla y el c\u00f3digo de idioma en<\/code>.<\/p>\n\n\n\n
    <\/p>\n\n\n\n
    \u00bfQu\u00e9 no puedes hacer en el sandbox?<\/h2>\n\n\n\n
    El sandbox no puede enviar mensajes a nadie m\u00e1s que a su destinatario fijo, enviar plantillas fuera de su conjunto de tres, subir ni recuperar archivos multimedia por ID de multimedia, ni superar los 200 mensajes. Conocer estos l\u00edmites desde el principio muestra qu\u00e9 pruebas corresponden a un n\u00famero registrado.<\/p>\n\n\n\n
    Cada solicitud que llega a la API de mensajer\u00eda consume uno de los 200, incluso cuando el mensaje se rechaza. Cuando se agotan los 200, el sandbox devuelve HTTP 429. Revisar las cargas \u00fatiles antes de cada env\u00edo guarda el cupo para las pruebas reales.<\/p>\n\n\n\n
    Un n\u00famero en producci\u00f3n maneja cada l\u00edmite de otra forma:<\/p>\n\n\n\n
    L\u00edmite del sandbox<\/th>En un n\u00famero en producci\u00f3n<\/th><\/tr><\/thead>
    Un \u00fanico destinatario fijo<\/td>Clientes: mensajes de formato libre dentro de una ventana de atenci\u00f3n al cliente abierta, plantillas fuera de ella[2]<\/td><\/tr>
    Tres plantillas predefinidas<\/td>Las plantillas propias de la empresa, cada una aprobada antes de usarse (por qu\u00e9 se rechazan las plantillas<\/a>)<\/td><\/tr>
    Sin multimedia por ID de multimedia<\/td>Subida, recuperaci\u00f3n y eliminaci\u00f3n por ID de multimedia, con archivos guardados durante 30 d\u00edas desde su \u00faltimo uso[3]<\/td><\/tr>
    200 mensajes<\/td>Los l\u00edmites de mensajer\u00eda de Meta<\/a> para el n\u00famero<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    <\/p>\n\n\n\n
    <\/p>\n\n\n\n
    Sandbox o n\u00famero 555 proporcionado por Meta: \u00bfcu\u00e1l deber\u00edas usar?<\/h2>\n\n\n\n
    El sandbox sirve para una primera comprobaci\u00f3n del c\u00f3digo frente a la API, y un n\u00famero 555 proporcionado por Meta sirve para las pruebas que necesitan un n\u00famero de empresa est\u00e1ndar en la plataforma de WhatsApp Business. La elecci\u00f3n define qu\u00e9 demuestra la prueba y qu\u00e9 hay que reconstruir despu\u00e9s.<\/p>\n\n\n\n
    Pregunta<\/th>Sandbox<\/th>N\u00famero 555 proporcionado por Meta<\/th><\/tr><\/thead>
    Qu\u00e9 demuestra<\/td>Autenticaci\u00f3n, manejo del webhook y estructura de la carga \u00fatil<\/td>Comportamiento bajo las reglas de un n\u00famero de empresa est\u00e1ndar<\/td><\/tr>
    Qui\u00e9n lo emite<\/td>360Dialog<\/td>Meta, que tambi\u00e9n lo administra<\/td><\/tr>
    Ideal para<\/td>Comprobaciones de c\u00f3digo<\/td>Incorporaci\u00f3n, evaluaci\u00f3n, pruebas de integraci\u00f3n, demos y control de calidad interno<\/td><\/tr>
    Ad\u00f3nde puede ir<\/td>Queda vinculado a un \u00fanico destinatario de prueba<\/td>No puede pasar a otra WhatsApp account ni salir de la plataforma de WhatsApp Business<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    <\/p>\n\n\n\n
    Las empresas que cumplen los requisitos pueden obtener hasta dos n\u00fameros 555 de Meta durante Embedded Signup, cada uno con el c\u00f3digo de pa\u00eds +1 de Estados Unidos y el c\u00f3digo de \u00e1rea 555.[4] Un n\u00famero 555 se verifica autom\u00e1ticamente y sigue las reglas de precios y las calificaciones de calidad est\u00e1ndar. Aun as\u00ed, su nombre visible necesita aprobaci\u00f3n antes del primer mensaje. Facturamos cada uno a tarifas est\u00e1ndar, como un n\u00famero normal, y no reembolsamos los n\u00fameros 555 incorporados por error.[5] El tr\u00e1fico real de clientes va en un n\u00famero normal, porque la configuraci\u00f3n y el historial de un n\u00famero 555 no se pueden trasladar a uno nuevo.<\/p>\n\n\n\n
    <\/p>\n\n\n\n
    \u00bfQu\u00e9 cambia al pasar del sandbox a un n\u00famero en producci\u00f3n?<\/h2>\n\n\n\n
    Pasar a un n\u00famero en producci\u00f3n cambia la direcci\u00f3n del servidor, la clave de API y el webhook. El encabezado de autenticaci\u00f3n sigue igual. Planificar estos cambios antes de la migraci\u00f3n permite reutilizar el c\u00f3digo del sandbox.<\/p>\n\n\n\n
    Un n\u00famero en producci\u00f3n necesita una cuenta de WhatsApp Business (WABA) aprobada<\/a>, un n\u00famero de tel\u00e9fono registrado, una clave de API y un webhook HTTPS. Meta est\u00e1 dividiendo la WABA en una WhatsApp account, que contiene el n\u00famero de tel\u00e9fono, y una Messaging account, que contiene las plantillas, la facturaci\u00f3n y las suscripciones a webhooks.[6] Meta registra los n\u00fameros incorporados mediante Embedded Signup solo para la WhatsApp Cloud API<\/a>. Tres cosas cambian en el c\u00f3digo y la configuraci\u00f3n:<\/p>\n\n\n\n