Configurando webhooks para receber chamadas recebidas, mensagens e atualizações de status de chamadas (para usuários do Twilio)
Locais conectados à sua própria conta Twilio precisam dos webhooks corretos para que o Twilio possa encaminhar chamadas recebidas, mensagens recebidas e atualizações de status de chamada para a Salez.
Webhooks de voz são configurados no número de telefone individual do Twilio. A parte de mensagens pode ser configurada diretamente no número ou através de um Twilio Messaging Service vinculado, dependendo da configuração atual do número.
Este guia fornece os endpoints exatos de webhook, explica qual caminho de mensagens usar e inclui etapas de solução de problemas para chamadas, mensagens ou atualizações de status que não aparecem corretamente na Salez.
Importante
Estas instruções se aplicam a locais que usam sua própria conta Twilio. Não se aplicam a números de telefone gerenciados através do sistema nativo LC Phone da Salez.
Se outro aplicativo controla intencionalmente os webhooks existentes do número, substituir esses valores pode alterar como o tráfego de entrada é roteado. Confirme que o número deve rotearse para a Salez antes de substituir um webhook personalizado.
O que é Configuração de Webhooks do Twilio?
Os webhooks do Twilio informam ao Twilio onde enviar eventos quando alguém liga ou envia mensagem para um dos seus números Twilio. A configuração correta dos webhooks permite que a Salez receba esses eventos e os exiba ou processe dentro da subconta conectada.
A configuração de voz controla chamadas recebidas e atualizações de status de chamadas. A configuração de mensagens controla mensagens SMS/MMS recebidas.
Essas configurações são especialmente importantes após conectar uma conta Twilio existente, mover um número, alterar um Messaging Service ou solucionar problemas de chamadas ou mensagens que não aparecem corretamente na Salez.
Principais benefícios de uma configuração correta de webhooks
Os webhooks criam a conexão entre o Twilio e a Salez para comunicação de entrada. A configuração correta ajuda a evitar chamadas perdidas, mensagens perdidas e informações incompletas de status de chamadas.
- Roteamento de chamadas recebidas: Envie chamadas recebidas do Twilio para o endpoint de voz da Salez.
- Entrega de mensagens recebidas: Roteie a atividade de SMS/MMS recebida para a Salez.
- Sincronização de status de chamadas: Envie eventos de status de chamada de volta para a Salez usando o webhook dedicado de status de chamadas.
- Suporte a Messaging Service: Configure corretamente o recebimento de mensagens quando múltiplos números usam um Twilio Messaging Service.
- Solução de problemas mais rápida: Separe a configuração de voz, mensagens por número direto e Messaging Service para identificar rapidamente o ponto de falha correto.
Antes de começar
Confirmar a conta Twilio correta, o número de telefone e o caminho de mensagens antes de editar webhooks evita que alterações de configuração sejam aplicadas ao cliente ou número errado.
- Confirme que o local da Salez afetado usa uma conta Twilio conectada, não o LC Phone.
- Faça login na conta Twilio ou subconta que possui o número de telefone.
- Identifique o número de telefone exato que está apresentando o problema.
- Confirme se o número de telefone está vinculado a um Messaging Service.
- Não substitua valores de webhook pertencentes a outra integração intencional, a menos que o número deva agora rotear para a Salez.
A2P 10DLC é separado da configuração de webhook. O Twilio pode exibir avisos de registro A2P nas mesmas telas. Concluir a configuração do webhook não substitui os requisitos aplicáveis de registro A2P.
Endpoints de webhook em resumo
Cada tipo de evento deve apontar para o endpoint apropriado da Salez. Copie esses valores exatamente e use HTTP POST onde especificado.
| Evento | Campo do Twilio | Endpoint da Salez | Método |
|---|---|---|---|
| Chamada recebida | Uma chamada é recebida | https://services.leadconnectorhq.com/phone-system/voice-call/inbound | HTTP POST |
| Atualização de status de chamada | Status da chamada muda | https://services.leadconnectorhq.com/appengine/twilio/incoming_call_status | HTTP POST |
| SMS/MMS recebidos | Uma mensagem é recebida / Messaging Service Request URL | https://services.leadconnectorhq.com/appengine/twilio/incoming_message | HTTP POST |
| Fallback do Messaging Service | URL de fallback | https://services.leadconnectorhq.com/appengine/twilio/incoming_message | HTTP POST |
Não misture os endpoints. A URL de chamada de entrada, a URL de status de chamada e a URL de mensagem de entrada realizam funções diferentes.
Número direto vs. Messaging Service
A configuração de mensagens recebidas depende se o número Twilio está usando seu próprio webhook de mensagens ou pertence a um Messaging Service. Verifique a Configuração Ativa do número antes de alterar as configurações de mensagens.
| Configuração | Onde configurar mensagens recebidas |
|---|---|
| Sem Messaging Service vinculado | Configure diretamente a seção Mensagens do número de telefone. |
| Messaging Service vinculado | Abra o Messaging Service vinculado e configure suas configurações de Integração. |
A configuração de voz continua sendo gerenciada no número de telefone individual. Um Messaging Service vinculado altera o caminho de configuração de mensagens, não os passos de Configuração de Voz abaixo.
Como configurar webhooks do Twilio para a Salez
Configure primeiro a voz e depois as mensagens usando o caminho que se aplica ao número de telefone. Salve cada configuração antes de testar para que o Twilio use os valores de webhook atualizados.
Etapa 1: Abra o número de telefone do Twilio
- Faça login na conta Twilio ou subconta que possui o número afetado.
- Vá para Números de Telefone → Gerenciar → Números Ativos.
- Selecione o número de telefone que você deseja configurar.
Abrir Números Ativos do Twilio →
Etapa 2: Abra a guia Configurar do número
Após selecionar o número de telefone, abra Configurar. Esta página contém o roteamento, a Configuração de Voz e a configuração de Mensagens usadas pelo número.
Etapa 3: Confirme o roteamento de voz US1
Em Configuração de Voz, confirme que a área de Roteamento mostra que o roteamento de chamadas da Região United States (US1) está: Ativo. Se o US1 não estiver ativo, use os controles de roteamento do Twilio para atualizar a configuração antes de continuar.
Etapa 4: Configure chamadas recebidas e atualizações de status de chamada
A Configuração de Voz precisa de dois endpoints da Salez: um para novas chamadas de entrada e outro para alterações subsequentes de status de chamada.
| Configurar com | Webhook, TwiML Bin, Function, Studio Flow, Proxy Service |
| Uma chamada é recebida | Webhook |
| URL de chamada de entrada | https://services.leadconnectorhq.com/phone-system/voice-call/inbound |
| HTTP | HTTP POST |
| Se o manipulador primário falhar | Nenhuma alteração necessária para esta configuração. |
| URL de alteração de status de chamada | https://services.leadconnectorhq.com/appengine/twilio/incoming_call_status |
| HTTP de status de chamada | HTTP POST |
| Consulta do nome do chamador | Opcional. Deixe na configuração que preferir. |
Salve a configuração do número de telefone após inserir os valores.
Etapa 5: Confirme o roteamento de mensagens US1
Na configuração de Mensagens do número de telefone, confirme que o roteamento de mensagens da Região United States (US1) está: Ativo.
Etapa 6: Configure mensagens recebidas
Use o caminho que corresponda à configuração atual do número no Twilio.
- Mantenha-se na página Configurar do número de telefone individual.
- Em Mensagens, defina Configurar com para Webhook, TwiML Bin, Function, Studio Flow, Proxy Service.
- Defina Uma mensagem é recebida para Webhook.
- Insira:
https://services.leadconnectorhq.com/appengine/twilio/incoming_message - Defina o método para HTTP POST.
- Salve a configuração.
Se a Configuração Ativa exibir um Messaging Service vinculado, configure o recebimento de mensagens a partir desse serviço em vez de confiar apenas no campo de mensagens ao nível do número.
- Em Números Ativos, clique no Messaging Service vinculado.
- Abra Integração.
- Em Mensagens recebidas, selecione Enviar um webhook.
- Insira a seguinte Request URL:
https://services.leadconnectorhq.com/appengine/twilio/incoming_message - Defina o método da Request URL para HTTP POST.
- Insira a mesma URL como Fallback URL:
https://services.leadconnectorhq.com/appengine/twilio/incoming_message - Defina o método do Fallback URL para HTTP POST.
- Clique em Salvar.
O callback de status de chamada configurado anteriormente pertence à Configuração de Voz do número de telefone. Não copie a URL de status de chamada para o campo Delivery Status Callback do Messaging Service.
Etapa 7: Teste a configuração
Após salvar a configuração no Twilio, teste cada caminho de comunicação separadamente para identificar exatamente qual webhook está funcionando ou falhando.
- Ligue para o número Twilio a partir de um telefone externo e confirme se a chamada recebida chega à Salez.
- Envie um SMS para o número Twilio e confirme se a mensagem aparece em Conversas.
- Revise a atividade de chamada associada na Salez para confirmar se as informações de status de chamada estão sendo atualizadas.
Solução de problemas de webhooks do Twilio
Solucione o evento que está falhando em vez de alterar todos os webhooks de uma vez. Voz, status de chamada e mensagens usam campos de configuração separados, então um pode falhar enquanto os outros continuam funcionando.
Confirme que o número Twilio correto foi selecionado, que o roteamento de voz US1 está ativo, que Uma chamada é recebida está definido como Webhook, que a URL de chamada de entrada está exata, que o método é HTTP POST e que a configuração foi salva.
Verifique novamente a URL de Call status changes e confirme que ela usa HTTP POST. O endpoint de status de chamada é diferente do endpoint de chamada de entrada.
Primeiro determine se o número está vinculado a um Messaging Service. Se estiver, verifique as configurações de Integração do serviço. Se não estiver, verifique o webhook de mensagens ao nível do número. Também confirme se o número suporta SMS.
Revise os Logs de Mensagens do Twilio para a mensagem afetada. Confirme se a mensagem chegou ao Twilio, observe seu status e o Message SID, e use esses detalhes ao escalar o problema.
Se sua conta Twilio contiver múltiplas subcontas, confirme que o número de telefone afetado pertence à mesma subconta Twilio conectada ao local da Salez antes de alterar webhooks.
Verifique se outro aplicativo ou integração conectada está gerenciando o número Twilio. Substituir webhooks repetidamente sem identificar a integração que os possui pode causar conflitos de roteamento.
Perguntas frequentes
https://services.leadconnectorhq.com/appengine/twilio/incoming_message com HTTP POST.incoming_call_status pertence à Configuração de Voz do número de telefone em Call status changes. Ele não deve ser reutilizado como callback de status de entrega do Messaging Service.Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo