# Vensy API

- [Vensy API](https://vensy.com.br/docs/): Integre disparos WhatsApp e sincronize seu CRM com uma API server-to-server.
- [Início rápido](https://vensy.com.br/docs/quickstart/): Faça o primeiro disparo e consulte a entrega.
- [Autenticação](https://vensy.com.br/docs/authentication/): Proteja e gerencie as API keys usadas pela sua integração.
- [MCP](https://vensy.com.br/docs/connect-ai/): Conecte Claude, Codex ou ChatGPT à Vensy e gerencie os acessos autorizados.
- Mensagens
  - [Formatos de mensagem](https://vensy.com.br/docs/messages/): Escolha o payload correto para cada tipo de envio.
  - [Texto](https://vensy.com.br/docs/messages/text/): Envie mensagens de texto para um telefone em E.164.
  - [Mídia](https://vensy.com.br/docs/messages/media/): Envie imagem, áudio, vídeo ou documento por URL ou Base64.
  - [Localização](https://vensy.com.br/docs/messages/location/): Envie coordenadas geográficas com nome e endereço opcionais.
  - [Templates do WhatsApp Oficial](https://vensy.com.br/docs/messages/templates/): Envie templates aprovados pela Meta usando um canal WhatsApp Cloud.
- [API do CRM](https://vensy.com.br/docs/crm/): Sincronize contatos, empresas e negócios sem expor o tenant da integração.
- Webhooks de eventos
  - [Visão geral](https://vensy.com.br/docs/webhooks/): A Vensy avisa sua integração quando algo acontece no workspace.
  - [Primeiros passos com n8n](https://vensy.com.br/docs/webhooks/n8n/): Monte o fluxo mais comum — nó Webhook do n8n recebendo eventos da Vensy.
  - [Assinatura e segurança](https://vensy.com.br/docs/webhooks/signing/): Verifique que a requisição realmente veio da Vensy, com Node, Python ou o nó Code do n8n.
  - [Formato do evento](https://vensy.com.br/docs/webhooks/payload/): O envelope, o versionamento e exemplos reais de message.received e conversation.closed.
  - [Catálogo de eventos](https://vensy.com.br/docs/webhooks/events/): Os 23 tipos disponíveis, agrupados por família, e os curingas de assinatura.
  - [Entregas, falhas e reenvio](https://vensy.com.br/docs/webhooks/deliveries/): O que conta como sucesso, a tabela de retentativas, desativação por inatividade e a API de gestão.
- Automações comerciais
  - [Automações comerciais](https://vensy.com.br/docs/automations/): Do formulário do site ao CRM e WhatsApp, sem precisar de um atendimento já aberto.
  - [Conectar formulários e webhooks](https://vensy.com.br/docs/automations/webhooks/): URL exclusiva, Bearer ou HMAC no servidor, e formulários públicos protegidos por Turnstile.
  - [Blocos e mapeamento de dados](https://vensy.com.br/docs/automations/blocks/): Conecte o formulário ao CRM, à distribuição comercial e às ações externas.
  - [Criar fluxos com IA e importar JSON](https://vensy.com.br/docs/automations/ai-contract/): Contrato versionado, receitas legíveis por máquina e regras para assistentes externos.
  - [Execuções, limites e recuperação](https://vensy.com.br/docs/automations/operations/): Entenda pausas, falhas confirmadas, resultados incertos e consumo do plano.
- Confiabilidade
  - [Integração confiável](https://vensy.com.br/docs/reliability/): Evite duplicidade e trate falhas transitórias com segurança.
  - [Idempotência](https://vensy.com.br/docs/reliability/idempotency/): Reenvie uma operação sem disparar a mesma mensagem duas vezes.
  - [Processamento assíncrono](https://vensy.com.br/docs/reliability/asynchronous/): Persista o disparo e responda sem aguardar o provedor.
- [Status de entrega](https://vensy.com.br/docs/delivery-status/): Consulte o estado conhecido de uma mensagem no provedor.
- [Erros e limites](https://vensy.com.br/docs/errors-and-limits/): Interprete códigos estáveis e decida quando repetir uma chamada.
- Referência da API
  - [Enviar mensagem](https://vensy.com.br/docs/api-reference/send-message/): Contrato completo para texto, mídia, localização e templates.
  - [Enviar template oficial](https://vensy.com.br/docs/api-reference/send-template/): Contrato completo para templates do WhatsApp Cloud.
  - [Consultar status de entrega](https://vensy.com.br/docs/api-reference/get-message-status/): Contrato completo da consulta de status por ID do provedor.
- [Changelog](https://vensy.com.br/docs/changelog/): Mudanças relevantes no contrato e na experiência de integração.