PulpoChatStart free

BlogGuides

Cómo conectar Claude con WhatsApp (y por qué una de las cuatro vías no funciona)

7 min read

Not translated yet: shown in Spanish.

Si has buscado cómo conectar Claude con WhatsApp, es probable que te hayas encontrado con dos cosas: guías que dan por hecho que existe una extensión de navegador, y guías que te mandan al sitio donde el montaje no puede autenticarse. Vamos con las dos.

No es una extensión. Es un conector

Claude no se «instala» en WhatsApp ni al revés. Lo que se hace es darle a Claude una herramienta con la que trabajar, mediante un protocolo que se llama MCP, y esa herramienta es tu cuenta de WhatsApp.

La diferencia importa porque cambia dónde vive todo. Una extensión se instala en tu navegador y funciona mientras tú tengas el navegador abierto. Un conector MCP es una dirección a la que Claude llama con una clave, así que funciona igual desde la web, desde la aplicación de escritorio o desde el terminal, y no depende de que tengas una pestaña abierta.

Cuando está montado, Claude puede leer tus conversaciones, buscar en ellas, mandar mensajes, gestionar contactos y etiquetas, y lanzar campañas. Son 47 herramientas repartidas en dieciocho ficheros, y las ves en la propia interfaz de Claude una vez conectado.

Lo que hace falta antes de empezar

Dos cosas, y las dos se consiguen en un minuto:

  1. Una cuenta con al menos un número de WhatsApp conectado. Sin número no hay nada que consultar.
  2. Una clave de API, que es lo que autoriza a Claude a llegar a tu WhatsApp. Se saca de los ajustes de tu cuenta y se puede regenerar cuando quieras.

Esa clave es la llave de tu bandeja de entrada. Trátala como una contraseña: no la pegues en un chat, no la subas a un repositorio y no la metas en una URL. Sobre esto último volvemos enseguida, porque es el meollo de este artículo.

Las cuatro vías, y cuál te toca

Lo que quieres La vía
Usarlo desde la aplicación de escritorio El fichero de configuración de Claude Desktop
Usarlo desde el terminal o el editor Claude Code
Montarte tu propia aplicación La API de Anthropic
Usarlo desde claude.ai en el navegador Hoy, ninguna que sea segura

Esa última fila es la razón de este artículo.

Por qué el conector del navegador no vale hoy

El diálogo de conectores personalizados de claude.ai te pide dos cosas: una URL y, en los ajustes avanzados, credenciales de OAuth. No tiene un campo para una cabecera.

Y nuestro servidor MCP se autentica con una cabecera Authorization. Así que cuando pegas la dirección del conector y le das a añadir, no hay forma de que Claude mande tu clave.

Existe un atajo, y es exactamente el que no deberías tomar: pegar la clave en la propia URL, con un ?key= al final. Funciona, y lo aceptamos por compatibilidad con montajes antiguos, pero está marcado como obsoleto en nuestro propio código y el comentario dice por qué: las URLs acaban en los registros de acceso, en los registros de los proxys y en el historial del navegador. Una contraseña que viaja en la barra de direcciones deja copias en sitios que tú no controlas y que nadie limpia.

Así que la recomendación es la que es: si quieres usarlo hoy, monta la vía de escritorio o la de terminal. Las dos mandan la clave en una cabecera, que es donde va. Y en cuanto los conectores de claude.ai admitan cabeceras, la vía del navegador pasa a ser la más cómoda de todas.

Preferimos decirlo así, con la contradicción a la vista, antes que dejarte descubrirla a mitad del montaje.

La vía de escritorio, en una idea

Claude Desktop lee un archivo de configuración donde declaras tus servidores MCP. Ahí pones la dirección del conector y tu clave, y la clave viaja en una cabecera. Es un archivo local, no una URL, así que no se filtra a ningún registro.

La vía del terminal, en otra

Claude Code registra conectores con un comando. Mismo principio: la clave va en una cabecera y se queda en tu configuración local. Es la vía natural si ya trabajas en el terminal, porque no tienes que salir de él para preguntarle a Claude por una conversación.

Los pasos exactos de las dos, con capturas, están en el centro de ayuda. Este artículo es sobre cuál elegir y por qué, que es la parte que ninguna guía cuenta.

Qué se puede hacer una vez montado

Lo interesante no es «Claude puede mandar un WhatsApp». Es que Claude puede leer lo que hay en tu bandeja y trabajar sobre ello. Un par de ejemplos de cosas que la gente pide de verdad:

  • «Mírame las conversaciones sin contestar de esta semana y dime cuáles llevan más tiempo esperando.»
  • «Busca en el chat de este cliente qué presupuesto le pasamos y resúmelo.»
  • «Etiqueta como urgentes las conversaciones donde alguien haya escrito dos veces sin respuesta.»

Es una diferencia de fondo respecto a un chatbot. Un chatbot contesta a tus clientes. Esto contesta a ti, sobre tus clientes.

Si no arranca, mira esto primero

Casi todos los fallos de montaje son el mismo fallo con distinta cara: la clave no llega o no es la que crees.

«Invalid or missing API key». Es el mensaje literal que devuelve el servidor cuando no encuentra ninguna clave utilizable, y pide expresamente que vaya en la cabecera Authorization. Si lo ves después de pegar la dirección en el conector del navegador, no es un fallo tuyo: es lo que contamos arriba.

Una clave que parece corta o parece larga. El servidor descarta de entrada cualquier cosa que no tenga entre 30 y 200 caracteres, así que una clave a medio copiar ni siquiera llega a comprobarse. Si copiaste con doble clic en vez de seleccionar el campo entero, empieza por ahí.

Un Bearer de más o de menos. Da igual: el servidor acepta la cabecera con prefijo y sin él, y se queda con la parte que importa. Este no es tu problema.

Ninguna herramienta a la vista en Claude. Entonces el conector no llegó a registrarse. Reinicia la aplicación de escritorio después de tocar el fichero de configuración: se lee al arrancar, así que un cambio en caliente no se ve.

Dos advertencias antes de dejarte con ello

Claude ve lo que ve tu clave. No hay un modo «solo lectura»: si le das la llave, tiene las herramientas que tiene, incluidas las de mandar mensajes. Antes de conectarlo, ten claro que el modelo va a poder escribir en nombre de tu negocio si se lo pides, o si le pides algo que él interprete así.

Y es una beta. El servidor MCP está publicado como tal, y algunas herramientas cambiarán de forma. Se usa y se trabaja con ello, pero si vas a montar encima algo de lo que dependa tu operación, cuenta con eso.

Keep reading

Product7 min

Cuándo dejar que un agente de IA conteste, y cuándo no

Las cinco puertas que un agente de IA debe pasar antes de abrir la boca, la salida que el cliente tiene que tener siempre, y las tres cosas que no puede contestar solo.

Not translated yet: shown in Spanish.

Guides7 min

WhatsApp Business o API oficial: lo que la API te quita

Todas las comparaciones cuentan lo que ganas. Esta cuenta lo que pierdes, con la lista exacta: editar, borrar y el «escribiendo» dejan de funcionar. Y quién cobra qué.

Not translated yet: shown in Spanish.

Guides6 min

¿De qué país es este número de WhatsApp?

Del prefijo se saca el país, y con una comprobación se sabe si el número está en WhatsApp y si es una cuenta de empresa. De quién es, no.

Not translated yet: shown in Spanish.

Now see it in your business.

A visible example, the setup you need and the next step to use it with your team.

See the product in action
PulpoChatShared inbox
Carmen OrtizChat assigned
Sara

Hi, can you help me with my order?

Hi, Carmen! We’ll check your order and confirm here.

The team can see who is handling the chat.

Start for free

Create your account here. Connect your number from a computer.

Seven days free, no card.