Notificações
O serviço de notificações da Rapid envia alertas para uma variedade de eventos de reserva, assim você pode simplificar as suas operações e escalar de maneira eficaz.
O serviço de notificações permite que você se integre ainda mais com a Rapid. Quando ocorrem alterações de reserva que podem afetar a sua empresa ou as suas operações, a API de notificações envia os detalhes da alteração direto para os seus sistemas via mensagens POST padrão. Com as nossas notificações de push, você pode se manter a par, simplificar operações e dimensionar os seus negócios.
Oferecemos suporte a todos os eventos de reserva que ocorrem fora da nossa API. Portanto, se um agente da central de atendimento fizer uma alteração ou um hotel cancelar uma reserva, você vai receber uma notificação no mesmo instante.
À medida que adicionamos recursos e funcionalidades à Rapid API, incluímos novos tipos de eventos de notificação para melhorar a sua experiência.
Ao ativarem uma integração perfeita com a sua empresa, essas notificações servem para complementar a Rapid API, o Affiliate Voyager e outros serviços de suporte a parceiros e clientes.
Tipos de eventos compatíveis
O serviço de notificações da Rapid pode informar os seus sistemas com uma mensagem sobre os seguintes eventos:
| Valor do event_type | Origem | Evento | Detalhes |
|---|---|---|---|
itinerary.agent.create | Agente de atendimento ao cliente ou Affiliate Voyager | Criação da reserva | Uma nova reserva foi criada por um agente de atendimento ao cliente da Rapid ou do Affiliate Voyager. |
itinerary.agent.change | Agente de atendimento ao cliente ou Affiliate Voyager | Atualização de reserva | Uma reserva existente foi atualizada por um agente de atendimento ao cliente da Rapid ou do Affiliate Voyager. |
itinerary.agent.cancel | Agente de atendimento ao cliente ou Affiliate Voyager | Cancelamento de reserva | Uma reserva existente foi cancelada por um agente de atendimento ao cliente da Rapid ou do Affiliate Voyager. |
itinerary.supplier.cancel | Hotel | Cancelamento de reserva | Uma reserva existente foi cancelada pelo hotel. O cliente deve entrar em contato com o serviço de atendimento ao cliente da sua empresa. |
itinerary.supplier.confirm | Hotel | Atualização de reserva | O hotel atualizou o ID de confirmação da propriedade para a reserva. |
itinerary.fraud.cancel | Expedia | Cancelamento de reserva | Uma reserva existente foi cancelada pela Expedia porque não estava em conformidade com os termos e condições da transação. O cliente precisa enviar uma mensagem a transactionprocessing@travelscape.com informando o número de telefone e o melhor horário para conversar sobre o cancelamento. |
itinerary.supplier.change | Fornecedor | Atualização de reserva | Uma reserva existente é alterada pelo hotel devido a atraso na chegada ou check-out antecipado do viajante. |
itinerary.traveler.noshow | Fornecedor | No show de viajante | O viajante não compareceu e o fornecedor marcou a reserva como No show. |
itinerary.supplier.refund | Fornecedor | Atualização de reserva | Para reservas Expedia Collect, o hotel vai fornecer os reembolsos solicitados por viajantes. É dever do parceiro garantir que o viajante receba os reembolsos. |
itinerary.message.received | Hotel | Nova comunicação da Central de mensagens da propriedade | A propriedade enviou uma nova comunicação pela Central de mensagens (PMC). Esse evento contém o texto completo da mensagem, bem como os seus tópicos gerais. Além da notificação, as mensagens também podem ser acessadas por e-mail e pela ferramenta PMC. Observação: é necessário se integrar com a Central de mensagens para receber esses tipos de notificações. Para mais informações sobre a Central de mensagens, clique aqui. |
Esquema e detalhes do evento
Todos os eventos de notificação POST seguem o esquema descrito abaixo. À medida que novos tipos de eventos são adicionados em eventos diferentes, o esquema sofre alterações.
| Objeto | Descrição |
|---|---|
event_id | Identificador único para cada evento. |
event_type | Uma indicação de qual evento causou a notificação Este valor pode ser usado no tratamento e no roteamento da mensagem. Consulte a lista de tipos de evento para mais informações. |
event_time | O registro de data e hora da notificação do evento, em UTC. |
itinerary_id | O ID do itinerário da reserva afetada. |
email | O e-mail do cliente associado ao itinerário afetado. |
message | Informações sobre o evento de notificação. Para eventos do tipo itinerary.message.received, essas informações contêm o texto real da mensagem do fornecedor. Em todos os outros tipos de eventos, serão uma descrição estática e de fácil compreensão do evento em inglês. |
affiliate_reference_id | O número de referência do afiliado da reserva afetada. |
topic_tags | As tags relativas ao tópico do evento. Elas aparecem apenas em eventos do tipo itinerary.message.received. Será uma lista de tags que podem estar presentes no texto da mensagem, de acordo com uma análise nossa. |
Cada notificação é uma solicitação HTTPS POST com um corpo de mensagem JSON.
Observação: é preciso habilitar você em cada tipo de evento, um a um, para receber esses tipos de notificações. Se você quiser habilitar um novo tipo de evento de notificações, entre em contato com o suporte.
Exemplo de itinerary.agent.create
{
"event_id": "dbacce6c-afcb-4b23-ae66-48050757551c",
"event_type": "itinerary.agent.create",
"event_time": "2017-08-09T16:47:32.039Z",
"itinerary_id": "8091234567890",
"email": "customer@example.com",
"message": "An agent created a new itinerary.",
"affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}Exemplo de itinerary.supplier.confirm
{
"event_id": "e02d6f41-4708-476f-915d-8a7032942e94",
"event_type": "itinerary.supplier.confirm",
"event_time": "2018-04-28T20:31:03.423Z",
"itinerary_id": "8999989898988",
"email": "alice@example.com",
"message": "The supplier confirmed one or more rooms on this itinerary.",
"affiliate_reference_id": "R194193582",
"rooms": [
{
"confirmation_id": {
"expedia": "926784314",
"property": "BEF23123AA"
}
},
{
"confirmation_id": {
"expedia": "926784315"
}
}
]
}Exemplo de itinerary.message.received
{
"event_id": "1aed5641-7285-4c42-b079-f5f2f139d148",
"event_type": "itinerary.message.received",
"event_time": "2023-11-14T02:33:18.860105363Z",
"itinerary_id": "9025254271673",
"email": "john@email.com",
"message": " We accept your request for a river view room. You will be able to check in at 11:00 AM. Please also note that the pool will be closed for scheduled maintenance on the day of your arrival, it will be open normal hours (9 AM to 10 PM) for the remainder of your stay. Looking forward to your visit.",
"topic_tags": "Check-in, Property/Amenity Closure",
"affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}Detalhes da API
Explore as definições dos pontos de extremidade relacionados a notificações nesta página e use o API Explorer ou outro software de teste para comparar os exemplos e as definições de esquemas com o resultado real.
Próximos passos
Entre em contato com o seu representante do Expedia Group ainda hoje para iniciar a integração do seu serviço de notificações.
Explore as definições dos pontos de extremidade relacionados a notificações nesta página e use o API Explorer ou outro software de teste para comparar os exemplos e as definições de esquemas com o resultado real.