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

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

          
          
        
Response

          
        
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>