O que é um webhook de atendimento?

É uma notificação HTTP que a plataforma da TW Solutions envia para uma URL sua sempre que um evento acontece no atendimento, como uma nova mensagem ou um atendimento finalizado. Assim seu sistema reage em tempo real, sem ficar consultando a API repetidamente.

Qual a diferença entre webhook e ficar consultando a API?

Consultar a API (polling) significa perguntar de tempos em tempos se algo mudou, o que sobrecarrega o serviço e gera atraso. Com webhook, é a plataforma que avisa no instante do evento. É mais rápido, mais eficiente e evita chamadas desnecessárias.

Como garanto que a chamada veio mesmo da plataforma?

Os webhooks usam autenticação por token. Cada chamada enviada à sua URL carrega uma credencial que o seu servidor confere antes de processar o dado, descartando requisições que não tragam o token correto e protegendo contra chamadas forjadas.

Quais eventos posso receber por webhook?

Os webhooks fazem parte da API pública da TW Solutions e cobrem eventos do atendimento, como mensagens recebidas e mudanças de status. A lista completa e o formato de cada payload ficam descritos na documentação interativa da API para desenvolvedores.

Preciso ser desenvolvedor para usar webhooks?

Sim, a configuração envolve expor um endpoint HTTP capaz de receber e validar as chamadas. É uma tarefa de desenvolvimento simples, e a documentação da API descreve os eventos e payloads para orientar a implementação e os testes.

Webhooks servem para integrar com meu CRM ou ERP?

Servem, e é um dos usos mais comuns. Um evento de atendimento pode atualizar o status no CRM ou sincronizar cadastros no ERP no exato momento em que acontece, mantendo todos os sistemas alinhados sem processos em lote com atraso.

Webhooks de Integração

bolt Em resumo

Webhooks de integração são notificações HTTP que a plataforma envia automaticamente para uma URL sua sempre que um evento acontece — como uma nova mensagem, um atendimento aberto ou finalizado — permitindo que sistemas externos reajam em tempo real, sem ficar consultando a API repetidamente.

check_circleEventos do atendimento são enviados à sua URL em tempo real
check_circleAutenticação por token para garantir a origem das chamadas
check_circleModelo push: a plataforma avisa, você não precisa ficar consultando
check_circleFazem parte da API pública, com documentação para desenvolvedores
check_circleMantêm CRM, ERP e sistemas internos sincronizados automaticamente
check_circlePayload estruturado, pronto para o seu sistema processar

O que são webhooks

Webhook é o oposto de ficar perguntando 'já mudou alguma coisa?'. Em vez do seu sistema consultar a API repetidamente para descobrir novidades, a plataforma da TW Solutions envia uma notificação para uma URL que você cadastra assim que um evento acontece. É o modelo push: quem tem a informação avisa, na hora.

Cada notificação carrega um payload estruturado descrevendo o que ocorreu — por exemplo, uma nova mensagem recebida ou um atendimento finalizado. Seu sistema recebe, valida a origem pelo token e executa a ação que fizer sentido, como atualizar um cadastro ou disparar um processo interno.

Por que polling não escala

Sem webhooks, a única forma de saber o que muda no atendimento é consultar a API de tempos em tempos. Isso gera um dilema ruim: consultar com frequência sobrecarrega a API e gasta recursos à toa; consultar devagar deixa seus sistemas defasados, reagindo minutos depois do que já aconteceu.

Esse atraso quebra automações que dependem de tempo real, como notificar um vendedor sobre uma resposta quente ou atualizar o status no CRM na hora do fechamento. Além disso, o polling desperdiça chamadas: a maioria delas retorna 'nada mudou'.

Webhooks resolvem os dois lados: zero polling desnecessário e reação imediata, no exato momento do evento.

Como configurar e receber eventos

Você cadastra a URL do seu endpoint e um token de autenticação. A partir daí, sempre que um evento assinado ocorre, a plataforma faz uma chamada HTTP para essa URL enviando o payload do evento. Seu servidor valida o token, confirma que a chamada é legítima e processa os dados.

Como os webhooks fazem parte da API pública da TW Solutions, a documentação para desenvolvedores descreve os eventos disponíveis e o formato de cada payload. Isso permite implementar a integração com previsibilidade e testá-la contra a especificação.

Cadastre a URL do seu endpoint e o token
A plataforma envia o evento assim que ele acontece
Seu sistema valida o token antes de processar
O payload estruturado descreve o que ocorreu
Consulte a documentação da API para os eventos disponíveis

Autenticação por token e confiabilidade

Como o seu endpoint fica exposto para receber chamadas, garantir que elas realmente vêm da plataforma é essencial. Por isso os webhooks da TW Solutions usam autenticação por token: cada chamada carrega uma credencial que o seu servidor confere antes de aceitar o dado, descartando requisições que não tragam o token correto.

Esse mecanismo protege contra chamadas forjadas e dá a você um ponto de controle claro. Combinado a boas práticas no seu lado — como responder rápido e processar de forma idempotente — o resultado é uma integração confiável, que não perde nem duplica eventos importantes.

Casos de uso de integração

Webhooks são a cola entre a plataforma e o resto do seu ecossistema. Um evento de atendimento finalizado pode atualizar o status no CRM; uma nova mensagem pode alimentar um dashboard interno em tempo real; um atendimento aberto pode registrar um chamado em um sistema de tickets externo.

Times de dados usam webhooks para alimentar data warehouses sem processos em lote pesados. Operações usam para acionar alertas quando algo importante acontece. E integrações com ERP mantêm cadastros e histórico sincronizados no instante do evento, sem janelas de atraso.