SMS recebidos

Resposta direta

Direcione SMS recebidos para webhooks, conversas, contatos e fluxos de trabalho de transferência de IA.

Conteúdo fonte

Um SMS recebido cria uma mensagem recebida, atualiza a conversa e pode acionar endpoints de webhook configurados.

## Payload da mensagem recebida

```json
{
  "type": "message.received",
  "message_id": "msg_123",
  "conversation_id": "conv_123",
  "from": "+15551234567",
  "phone_number": "+15557654321",
  "body": "Can I reschedule?",
  "received_at": "2026-04-28T14:00:00Z"
}
```

Use roteamento de entrada para agentes de IA, caixas de entrada de suporte, qualificação de leads e fluxos de trabalho de agendamento.

## Padrão de roteamento para agentes de IA

1. Configure um endpoint na página Webhooks.
2. Assine `message.received` e `conversation.updated`.
3. Faça com que seu serviço decida se o agente de IA deve responder, pausar ou transferir.
4. Envie a resposta via `POST /api/v1/messages` usando os mesmos metadados da conversa.

```js
export async function handleInboundTextreeEvent(event) {
  if (event.type !== "message.received") {
    return;
  }

  const shouldEscalate = event.body.toLowerCase().includes("human");

  if (shouldEscalate) {
    await pauseAgentAndNotifyOperator(event.conversation_id);
    return;
  }

  await fetch("https://api.texttree.ai/api/v1/messages", {
    method: "POST",
    headers: {
      Authorization: `Bearer undefined`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      phone_number: event.from,
      body: "Thanks. I can help with that.",
      metadata: {
        conversation_id: event.conversation_id,
        source: "ai_agent",
      },
    }),
  });
}
```

## Transferir comportamento para humanos

As conversas recebidas podem se mover entre estes estados do operador:

-`AI active`
-`Human takeover`
-`Paused`
-`Resolved`

Quando a IA é pausada ou um ser humano assume o controle, sua integração deve interromper as respostas automatizadas
até que a conversa seja retomada.