v1.0
Painel

DeskHotel Tracking API

Capture dados de conversao das suas Landing Pages e integre automaticamente ao CRM do DeskHotel.

Gere um Token no painel em Configuracao > Tracking de Leads
Integre na LP usando Script JS (frontend) ou API REST (backend)
Dados no CRM — conversoes aparecem no perfil do lead automaticamente
Workflows — dispare acoes automaticas quando um lead converter
Base URL:  https://track.chatbooking.com.br

Autenticacao

A API usa Token de Acesso para identificar seu hotel. O token e enviado no body de cada request — nao em headers.

Importante: O token identifica seu hotel. Mantenha-o seguro. Gere tokens em Configuracao > Tracking de Leads no painel.

Formato do token

Tokens seguem o padrao dh_ + 64 caracteres hexadecimais. Exemplo:

dh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

POST Registrar conversao

Registra uma conversao de lead vinda de uma Landing Page. Insere os dados na timeline do lead e dispara workflows automaticamente.

POST https://track.chatbooking.com.br/api/tracking/conversion

Body Params

token
stringrequired
Token de acesso do hotel, gerado no painel.
telefone
stringrequired
Telefone do lead no formato: DDI + DDD + numero (com ou sem nono digito). Ex: 551199887765 ou 557399931534
nome
stringoptional
Nome completo do lead.
email
stringoptional
Email do lead.
evento
stringoptional
Nome do evento de conversao (ex: formulario_LP, click_whatsapp).
utm_source
stringoptional
Origem do trafego (Google, Facebook, Instagram, etc.).
utm_medium
stringoptional
Tipo de midia (cpc, email, organic, social, referral).
utm_campaign
stringoptional
Nome da campanha (verao2025, blackfriday).
utm_content
stringoptional
Variacao do anuncio (banner_topo, video_lateral).
utm_term
stringoptional
Termo de busca pago (hotel aquiraz, pousada fortaleza).
produto
stringoptional
Produto de interesse (Suite Master, Pacote Familia).
destino
stringoptional
Destino de interesse (Aquiraz, Fortaleza).
valor
stringoptional
Valor estimado da reserva.
periodo
stringoptional
Periodo da viagem (15/01 a 20/01).
url
stringoptional
URL da Landing Page. Preenchido automaticamente pelo script JS.

Parametros UTM

Os parametros UTM permitem rastrear a origem do trafego das suas campanhas de marketing.

utm_source
De onde veio o trafego — google, facebook, instagram, email
utm_medium
Tipo de midia — cpc, organic, social, email, referral
utm_campaign
Nome da campanha — verao2025, blackfriday, lancamento
utm_content
Variacao do anuncio — banner_topo, video_lateral, cta_azul
utm_term
Termo de busca pago — hotel aquiraz, pousada fortaleza

Exemplo de URL

https://minha-lp.com/pacote-verao?utm_source=google&utm_medium=cpc&utm_campaign=verao2025

Rate Limits

Limite por token
100 requests por minuto por token. Contador reseta a cada 60 segundos.
HTTP 429
Retornado quando o limite e excedido. Aguarde 1 minuto e tente novamente.

Workflows Automaticos

Cada conversao registrada dispara automaticamente workflows configurados com o trigger Lead convertido na LP.

Acesse CRM > Workflows no painel e crie um novo workflow
Selecione o trigger "Lead convertido na LP" (grupo Conversao)
Configure acoes: enviar WhatsApp, atribuir atendente, mover fase no funil
Exemplo: Lead converte na LP → envia mensagem de boas-vindas no WhatsApp → move para fase "Novo Lead" no funil.

Script JS

DEPRECATED
Aviso de descontinuacao: O Script JS sera descontinuado em julho de 2026. Recomendamos migrar para a API REST, que oferece mais seguranca e controle. O script continuara funcionando ate a data de descontinuacao.

O script captura UTMs automaticamente da URL e expoe DeskHotel.track() para envio de dados.

1. Adicione o script

<script src="https://track.chatbooking.com.br/dh.js?token=SEU_TOKEN"></script>

2. Envie os dados no formulario

Chame DeskHotel.track(data) no submit. O campo telefone e obrigatorio. UTMs sao incluidos automaticamente.

API do Script

DeskHotel.track(data)
Envia dados de conversao. Retorna Promise. Merge automatico com UTMs salvos da URL. Campo telefone obrigatorio.
Migracao: Para migrar, substitua a chamada DeskHotel.track() por uma chamada fetch() direta para a API REST. Veja exemplos no painel de codigo ao lado.
Credentials
API Token Body parameter
Gere seu token em Configuracao > Tracking de Leads no painel.
Language
Request
Responses
200 OK
{
  "success": true,
  "message": "Conversao registrada com sucesso"
}
401 Unauthorized
{
  "error": "Token invalido ou revogado"
}
400 Bad Request
{
  "error": "telefone e obrigatorio"
}
Script JS Example
<!-- Adicione antes do </body> -->
<script src="https://track.chatbooking.com.br
  /dh.js?token=SEU_TOKEN"></script>

<script>
document.getElementById('form')
  .addEventListener('submit', function(e) {
    e.preventDefault();
    // UTMs capturados automaticamente
    DeskHotel.track({
      telefone: document.getElementById(
        'telefone').value,
      nome: document.getElementById(
        'nome').value,
      email: document.getElementById(
        'email').value,
      evento: 'formulario_contato',
      produto: 'Suite Master',
      destino: 'Aquiraz'
    }).then(function() {
      window.location = '/obrigado';
    });
  });
</script>