Soluções de conversação

Facilite conversas fluidas entre viajantes e propriedades, via API ou interface do usuário pre-built

API de Conversação

Com a API de Conversação, você pode facilitar a comunicação perfeita entre viajantes (ou agentes) e fornecedores de hospedagem. Após a integração, você poderá recuperar conversas sobre hotéis, aluguéis de temporada e ofertas da Vrbo, além de criar e visualizar mensagens via API.

Este recurso permite o envio de mensagens post-booking por meio de uma experiência de API end-to-end. Você pode controlar a experiência front-end incorporando conversas em suas próprias ferramentas traveler-facing e agent-facing para construir confiança com os viajantes, reduzir cancelamentos e custos de serviço e otimizar os fluxos de trabalho de suporte.

A API de Conversas também oferece suporte à funcionalidade de marcação de tópicos por meio de notificações. As tags de tópico são descrições de um ou mais caracteres do conteúdo das mensagens que podem ajudar a automatizar o suporte e garantir que as mensagens sejam encaminhadas para os canais corretos.

Leia mais sobre marcação de tópicos e supressão de AI-powered re-marketing em Recursos adicionais.

A API de Conversação é a única solução de conversação que oferece suporte ao estoque do Vrbo.

Como funciona a API de Conversação

A API de Conversação pode ser configurada para permitir o envio de mensagens diretamente entre o propriedade e o viajante, ou entre o propriedade e seus agentes de suporte, dependendo das suas necessidades. Em ambos os cenários, você acessará o link da API de Conversas por meio da resposta de recuperação do recurso "Gerenciar Reserva" para essa reserva e, em seguida, exibirá o ponto de entrada da conversa para o viajante ou agente. Quando um provedor enviar uma nova mensagem, você será notificado imediatamente por meio das Notificações.

Nota: A API de Conversação não vem com uma experiência de interface de usuário de mensagens pre-built. Você precisará desenvolver essa experiência ou conectar a API de Conversas à sua interface de usuário de mensagens existente.

Se você precisar de uma interface de usuário pre-built, consulte a Central de Mensagens propriedade.

Recupere a reserva através de Gerenciar Reserva.

Ao solicitar detalhes de reserva do endpoint Retrieve Booking da API Manage Booking, a resposta incluirá um link para a API Conversation no objetoconversations.

>> Saiba mais sobre a API de Gerenciamento de Reservas.

Nota: O add-messagelink para uma conversa é time-bound e expirará uma hora após ser emitido. Sempre faça uma nova chamada Retrieve para obter links atualizados em cada resposta, em vez de armazenar links de conversa a longo prazo.

Exemplo de um link de conversa na resposta:

{
  "itinerary_id": "8999989898988",
  "rooms": [
    {
      "id": "926784314"
    }
  ],
  "links": [
    "conversation": {
      "method": "GET",
      "href": "/v3/conversations/1234567890?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  ]
}

Ponto de partida para uma conversa informal com o viajante/agente

Você pode:

• Incorpore o link na sua interface traveler-facing para que os viajantes possam enviar ou receber mensagens diretamente com o propriedade. Os pontos de entrada mais comuns incluem a página de confirmação da reserva, a página de detalhes da viagem ou o e-mail de confirmação.
  Consulte os Recursos adicionais para obter as melhores práticas.
• Incorpore o link nas ferramentas para agentes para que suas equipes de suporte possam se comunicar com viajantes e propriedades.

Inscreva-se para receber notificações de novas mensagens.

Inscreva-se nos seguintes eventos conversation-related na API de Notificações Rápidas para receber mensagens supplier-initiated como notificações push:

• itinerary.message.received — Acionado quando o propriedade envia uma nova mensagem para o parceiro/viajante solicitante
• itinerary.message.rejected — Acionado quando uma mensagem propriedade é ​​suprimida após ser identificada como fraudulenta ou de phishing. A mensagem foi bloqueada e não foi entregue.
• itinerary.conversation.attachment.success — Acionado quando um anexo enviado por um viajante ou parceiro de demanda (como parte de uma mensagem de agente) é carregado e processado com sucesso.
• itinerary.conversation.attachment.failure — Acionado quando o envio de um anexo falha

>> Para obter mais informações sobre notificações de integração, consulte a página de Notificações.

Envio de mensagens para propriedades

A API de Conversas retorna o histórico completo de mensagens da reserva em uma única resposta, incluindo as mensagens enviadas por viajantes/agentes e as respostas do propriedade. As mensagens com a hashtag propriedade podem incluir anexos e links para acessá-los. Os tipos de anexos possíveis incluem PNG, PDF, JPEG e DOCX.

A mesma resposta também inclui os links usados ​​para enviar mensagens: um para texto simples e outro para iniciar o upload de um anexo.

Enviar uma mensagem de texto simples

Para iniciar uma nova mensagem ou responder ao propriedade, use o link add_messagepara adicionar uma mensagem à conversa. Uma resposta bem-sucedida retorna um link de conversa atualizado, que você deve manter e usar na sua próxima leitura para manter o estado do seu token atualizado.

Quando um agente envia uma mensagem em nome de um viajante, aparecerá como se tivesse sido enviada pelo próprio viajante, tanto na API quanto para o propriedade. Se o agente quiser indicar que a mensagem foi enviada por um agente, pode incluir uma nota como: "Enviado por um agente [Parceiro] em nome do viajante."

Envio de anexo

Os anexos são carregados diretamente para o Amazon S3. O fluxo começa com a solicitação da API de Anexos, que inclui os metadados do arquivo e, opcionalmente, o texto da mensagem que o acompanha. A resposta retorna um URL seguro do S3, sua data de expiração e os campos do formulário exigidos pela AWS. Os tipos de arquivo suportados incluem PNG, PDF e JPEG.

Observação: O texto fornecido nesta chamada é incluído no upload e publicado como mensagem quando o arquivo é entregue. Um separadoadd_message A chamada é, portanto, desnecessária — emitir uma resultará em uma mensagem duplicada na thread.

Antes que a URL segura do S3 expire, envie o arquivo via POST utilizando os campos do formulário fornecidos na resposta anterior da API de Anexos.

>> Consulte a documentação da AWS para obter mais detalhes.

O upload bem-sucedido para o S3 aciona uma verificação de malware no Rapid:

• Se o arquivo estiver limpo: ele é armazenado, uma mensagem contendo o anexo e seu texto correspondente é enviada para o canal propriedade, e umitinerary.conversation.attachment.success A notificação foi enviada.
• Se uma ameaça for detectada, o arquivo é excluído e umitinerary.conversation.attachment.failure A notificação foi enviada.

Exemplo de um objeto de conversa retornado pela API de Conversas:

{
  "itinerary_id": "987654321098",
  "expedia_confirmation_id": "1234567890",
  "property_id": "12345",
  "messages": [
    {
      "text": "Can I have an early check-in?",
      "participant": {
        "role": "traveler",
        "given_name": "John",
        "family_name": "Smith"
      },
      "creation_date_time": "2025-04-15T00:45:14.000Z",
      "message_type": "free_text",
      "delivery_status": "accepted"
    },
    {
      "text": "Please note that check-in time is 5pm and that you will need to meet with our receptionist to receive information about your room assignment.",
      "participant": {
        "role": "supplier"
      },
      "creation_date_time": "2025-04-15T00:10:12.000Z",
      "message_type": "free_text",
      "delivery_status": "accepted"
    }
  ],
  "links": {
    "add_message": {
      "method": "POST",
      "href": "/v3/conversations/1234567890/messages?token=MY5S3j36cOcL",
      "expires": "2025-04-15T00:45:14.000Z"
    },
    "add_attachment": {
      "method": "POST",
      "href": "/v3/conversations/1234567890/messages/attachments?token=MY5S3j36cOcL",
      "expires": "2025-04-15T00:45:14.000Z"
    }
  }
}

Validade do link e expiração do token

Os links paraadd_message eadd_attachment são temporárias, expirando na data e hora especificadas noexpires campo ou 30 dias após a data check-out, o que ocorrer primeiro. O link da conversa permanece válido por até 90 dias post-stay.

Avalie oexpires Valor do campo antes de cada chamada. Se já tiver passado, ou se receber um erro 401/403, re-run, a opção Recuperar Reserva ou Conversa serve para criar novos links.

Entre em contato com seu representante da Expedia Group para iniciar a integração da sua API de Conversas.

Supressão de AI-powered re-marketing e marcação de tópicos de mensagens

As mensagens Property-initiated identificadas como "re-marketing" (mensagens que promovem reservas diretas ou de outra forma off-platform) são suprimidas automaticamente pela API de Conversação e pelo Centro de Mensagens propriedade.

Para permitir um consumo mais fácil e escalável de mensagens property-initiated, nossas soluções de conversação empregam um modelo AI-driven que identifica os principais tópicos de uma mensagem e os entrega como tags no texto.itinerary.message.received evento de notificação. Você pode usar essas tags para potencializar a lógica de busca, roteamento, automação e supressão em seus próprios sistemas.

Possíveis tags de tópico da mensagem propriedade

Exemplo de payload de notificação itinerary.message.receivedcom tags de tópico:

{
  "event_id": "493ae7d4-fb3c-49fb-b180-0d7f4030aaeb",
  "event_type": "itinerary.message.received",
  "event_time": "2024-09-16T15:22:42.783857461Z",
  "itinerary_id": "9025294229844",
  "email": "test@travelnow.com",
  "message": "Please checkin before 12:00 PM!",
  "topic_tags": "Check-in",
  "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}

Aluguéis por temporada

Habilitar o envio de mensagens diretas para propriedades de aluguel de temporada é essencial, já que 84% dos imóveis para aluguel de temporada disponíveis em Rapid API não possuem recepção. Eles costumam recorrer às mensagens diretas para informar a hóspedes:

• Códigos de acesso personalizados para entrar na propriedade
• Orientações sobre comodidades exclusivas ou disponíveis na propriedade
• Instruções ou vagas de estacionamento

Nota: propriedade A Central de Mensagens não é compatível com os anúncios do Vrbo. Se você já distribui ou planeja distribuir estoque da Vrbo, recomendamos que integre a API de Conversas.

Central de mensagens da propriedade

Uma ferramenta de mensagens two-way que facilita a interação direta entre propriedades e viajantes ou agentes por meio de uma interface de mensagens pre-built, para uma experiência post-booking mais simplificada.

Como a Central de mensagens funciona

O Centro de Mensagens propriedade pode ser configurado para permitir a troca de mensagens diretamente entre o propriedade e o viajante, fornecendo o e-mail do viajante na solicitação de reserva, ou entre o propriedade e seus agentes de suporte, fornecendo o e-mail do agente na solicitação de reserva.

Exemplos de conversas na Central de Mensagens com a hashtag propriedade

Property-initiated mensagens O propriedade quer informar o viajante que oferece um serviço de transporte gratuito round-trip de/para o aeroporto.

Traveler-initiated mensagens O viajante solicitou acomodações com berço para sua reserva e deseja reconfirmar esta solicitação com o propriedade antes de sua chegada.

Acesse os requisitos de lançamento do propriedade Message Center Traveler e do Agent-Model no Expedia Partner Solutions:

>> Consulte a documentação da AWS para obter mais detalhes.
>> Saiba mais sobre os requisitos de lançamento do traveler-model
>> Leia sobre os requisitos de lançamento do agent-model

Entre em contato com seu representante da Expedia Group para iniciar a integração do seu Centro de Mensagens propriedade.

Recursos adicionais

Melhores práticas para expor o ponto de partida da conversa aos viajantes.

Aqui estão algumas orientações sobre como você pode disponibilizar o link da API de Conversas para os viajantes após eles concluírem a reserva.

1. Adicione um botão "Mensagem Hotel" ou "Mensagem para o anfitrião" à página de confirmação da reserva
   Isso permite que os viajantes que precisam fazer uma solicitação ou pedir informações ao propriedade imediatamente após fazer uma reserva.
   

   

2. Adicione o botão "Mensagem Hotel" ou "Mensagem para o anfitrião" à página do itinerário
   Isso permite que os viajantes entrem em contato com o propriedade diretamente da página de reserva.
   

   

3. Adicione o botão "Mensagem Hotel" ou "Mensagem para o Anfitrião" aos e-mails de reserva
   Isso ajuda a lembrar o viajante de entrar em contato com o propriedade quando receber atualizações ou lembretes de sua próxima estadia.
   

   

Tratamento de erros da API de Conversação

Existem vários erros que podem ser retornados em diferentes cenários, todos codificados como 400. A seguir, uma lista das causas comuns e a respectiva mensagem de erro:

Detalhes da API

Explore as configurações da API de Conversação nesta página e, em seguida, use o comando API Explorer ou outro software de teste para entender como os exemplos e as configurações de esquema se comparam à saída real.