Saltar al contenido
IdiomaES
Empezar gratis

API de WaliChat + webhooks

Tu sistema envía.Tu equipo conserva el chat.

Envía mensajes, recibe eventos y asigna conversaciones con la API de WaliChat. El resultado aparece donde tu equipo ya trabaja.

Empezar gratisVerlo en acción

Acceso a la API en WaliChat. Respeta las reglas de los mensajes y los límites de tu plan.

REST API
POST /v1/messages
  1. Tu sistemaPrepara el mensaje
  2. REST APIPOST /v1/messages
  3. WaliChatVisible en el chat

Tu pedido está listo para recoger.

Petición aceptada · la entrega se consulta aparte

Un desarrollador independiente revisa una integración desde la terraza de un café.

Tu equipo ve el mensaje enviado.

Envía una novedad del pedido

Recibe un evento entrante

Asigna el chat a Sara

De una petición a la bandeja del equipo.

Tres tareas conectadas: enviar, recibir y asignar.

Desliza para ver los ejemplos

Envía una novedad del pedido

POST /v1/messages

Indica el dispositivo conectado, el destinatario y el mensaje. Utiliza una plantilla aprobada cuando la API oficial la requiera.

REST API
POST /v1/messages
  1. Tu sistemaPrepara el mensaje

    device + phone + message

  2. REST APIPOST /v1/messages

    Autentica con tu clave API.

  3. WaliChatVisible en el chat

    Tu equipo ve el mensaje enviado.

Tu pedido está listo para recoger.

Petición aceptada · la entrega se consulta aparte

Una petición aceptada no garantiza la entrega. Consulta los eventos de estado y gestiona los errores en tu sistema.

Recibe un evento entrante

¿Puedo recoger mi pedido mañana?

Configura un webhook HTTPS y suscríbelo al evento de mensaje entrante.

Webhook

¿Puedo recoger mi pedido mañana?

  1. WhatsAppMensaje recibido

    El cliente escribe al número conectado.

  2. Webhookmessage:in:new

    El evento llega a tu endpoint HTTPS.

  3. Tu sistemaElige la siguiente acción

    Consulta, procesa y decide qué hacer.

message:in:new

Webhook enviado al endpoint configurado

Tu sistema decide el siguiente paso. Recibir un evento no envía automáticamente una respuesta.

Asigna el chat a Sara

PATCH /v1/chat/{device}/chats/{chat}/owner

Indica una persona o un departamento autorizado. Los departamentos dependen del plan.

REST API
PATCH /v1/chat/{device}/chats/{chat}/owner
  1. Tu sistemaElige quién atiende

    agent / email / department

  2. REST APIPATCH …/owner

    Actualiza la persona responsable de la conversación.

  3. WaliChatPasa el chat a Sara

    Sara continúa con el contexto que ya existe.

Conversación asignada

Sara es responsable del chat

La asignación y la nota organizan al equipo; no envían un mensaje al cliente.

Elige la conexión para cada tarea.

Usa tu sistema, un flujo o un cliente de IA compatible.

REST API

Consulta y actualiza mediante endpoints JSON documentados.

Webhooks

Recibe los eventos que configures en tu propio endpoint HTTPS.

MCP

Tu IA, conectada con tu negocio.

Las acciones API usan la autoridad de tu clave y los límites del plan. Las reglas y los cargos de Meta siguen aplicándose.

Consulta la referencia API

Empieza con la documentación real.

Una clave. Una prueba. Tu primer evento.

Empieza en la documentación con un número de prueba conectado y revisa cada respuesta.

  1. Crea una clave API

    Utiliza una cuenta autorizada para el número y conserva la clave en tu sistema.

  2. Prueba la petición

    Usa la documentación y el probador API con tus propios datos de prueba.

  3. Gestiona eventos y errores

    Configura tus webhooks y revisa códigos de respuesta, límites y estados de entrega.

Antes de empezar

  • Una cuenta de WaliChat con un número conectado y acceso a la API.
  • Un endpoint HTTPS para los webhooks que configures.
Empezar gratisVer planes y condiciones
Dos desarrolladores trabajan con una laptop en un espacio de trabajo compartido del barrio.
Sara · WaliChat

Tengo el chat y la nota. Sigo yo.

Cuando hace falta una persona, tu equipo tiene el chat.

Prepara el relevo para las excepciones. Tu equipo ve lo que ocurrió y sigue hablando con el cliente.

Mira cómo trabaja tu equipo

Una conversaciónCon los mensajes enviados

Una persona responsableAsignada a quien corresponde

Tus reglas de accesoRoles y acceso al número

Antes de tu primera petición API.

¿Una petición aceptada significa que se entregó?

No. Consulta los eventos de estado y la respuesta documentada. Tu sistema debe gestionar fallos y reintentos.

¿Qué pasa fuera de la ventana de atención de WhatsApp?

La API oficial de WhatsApp mantiene sus reglas. Fuera de la ventana de atención, utiliza una plantilla aprobada y respeta las condiciones y los costos de los mensajes.

Prepara el flujo. Sigue con tu negocio.

Empezar gratis

Empieza con WaliChat y elige un plan con Flows.