Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.
Um número da API Oficial (Cloud API) pode estar conectado a mais de uma
plataforma ao mesmo tempo: a D-API e um CRM, um chatbot, outra API. Na Meta,
cada plataforma é um parceiro (um app). Esta página explica como os dois
convivem sem um atrapalhar o outro.
Resumo em três frases. Os dois parceiros podem estar no número ao mesmo
tempo, mas cada conversa tem um único dono que responde. Quem decide quem é
dono de quê é a empresa dona do número, no Meta Business Suite. A D-API
mostra o papel dela, recebe cópia das conversas dos outros (standby) e, quando
autorizada, assume uma conversa a qualquer momento.
Por que isso existe
Sem nenhuma regra, todo parceiro conectado recebe todas as mensagens e todos
podem responder. Na prática isso vira bagunça: dois robôs respondendo o mesmo
cliente, ou um parceiro respondendo uma conversa que o outro estava atendendo.A Meta resolveu isso com o Conversation Routing (roteamento de conversas):
a empresa define qual parceiro atende cada tipo de conversa, e a Meta entrega a
mensagem só para ele.
Quando um segundo parceiro entra na conta, a Meta pode criar uma
configuração de roteamento automaticamente, a partir dos parceiros que já
estavam lá. Se a D-API (ou o outro parceiro) parou de receber mensagens ou
passou a receber o erro 131070 logo depois de uma nova conexão, é isso.
Confira a configuração no Meta Business Suite e o
papel da D-API.
Conceitos
Termo
O que é
Conversa
A troca de mensagens com um cliente num número. O roteamento vale por conversa, não pelo número inteiro: o mesmo número pode ter conversas com donos diferentes.
Dono
O parceiro que atende aquela conversa. É o único que recebe a mensagem do cliente como mensagem normal e o único que pode enviar mensagem de atendimento (texto livre na janela de 24h).
Entrada
Por onde a conversa começou. Define quem vira dono. São cinco: Atendimento (padrão), Anúncio de clique para WhatsApp, Resposta a template de marketing, Resposta a template de utilidade e Ligação.
Principal
O parceiro configurado para uma entrada. Vira dono quando a conversa começa por ela.
Standby
O parceiro observador: recebe cópia de tudo que acontece nas conversas dos outros (mensagens do cliente, o que o dono enviou e status), mas não responde.
Escalonamento
No máximo um parceiro por conta. Pode assumir qualquer conversa a qualquer momento, mesmo com outro dono. É o que torna possível o fallback.
Conversa livre
Sem dono. Acontece depois de 24h sem mensagem do cliente ou quando o dono solta a conversa. A próxima mensagem do cliente decide o dono de novo, pela entrada.
Templates sempre podem ser enviados, por qualquer parceiro, sendo dono ou
não. Enviar um template não muda o dono da conversa. O que pode mudar é a
resposta do cliente: se ele tocar num botão do template, a conversa é
roteada de novo pela entrada de marketing/utilidade.
1. Descubra a situação do número
Uma chamada mostra se há outros parceiros e qual é o papel da D-API:
exclusive: só a D-API está na conta. Tudo funciona como sempre.
shared_without_routing: há outro parceiro e nenhum roteamento. Os
dois recebem todas as mensagens e os dois podem responder. Configure o
roteamento para evitar respostas duplicadas.
routed: o roteamento está ativo. O que a D-API faz depende de roles e
isStandby.
string[]
Entradas em que a D-API é a principal: customer_service (atendimento),
ctwa (anúncio de clique para WhatsApp), marketing, utility, calls
(ligações). Contém escalation se a D-API é o parceiro de escalonamento.
Vazio quando a D-API não é principal de nada.
boolean
true se a empresa deu à D-API a visão standby (cópia das conversas dos
outros parceiros).
boolean
true se a D-API pode assumir qualquer conversa. Atalho para roles conter
escalation.
object[]
Parceiros (apps) conectados à conta. isCurrentApp: true marca a D-API.
number
Quantos parceiros além da D-API.
Esta rota consulta a Meta na hora, e a Meta limita a frequência. Use em telas
de configuração ou depois de um erro 131070. Não chame antes de cada
envio.
2. Configure o roteamento no Meta Business Suite
A configuração é da empresa dona do número e só existe na interface da
Meta. Nenhum parceiro (nem a D-API) consegue configurar por API.
1
Aceite os termos
Standby, escalonamento e troca de dono exigem que a empresa aceite os
Termos de Serviço de Meta Business Agents e da Plataforma. Sem isso,
só o roteamento básico funciona.
2
Abra o roteamento de conversas
No Meta Business Suite, abra as configurações da conta do WhatsApp e
procure Roteamento de conversas (Conversation Routing). Dá para
configurar a conta inteira ou um número específico (a configuração do
número tem prioridade).
3
Escolha o principal de cada entrada
Para cada uma das cinco entradas, escolha o parceiro que atende. Em
marketing e utilidade existe a opção “Rotear para quem enviou”: a
resposta do cliente vai para o parceiro que enviou o template.
4
Escolha o parceiro de escalonamento (opcional)
No máximo um. Ele pode assumir qualquer conversa.
5
Dê a visão standby (opcional)
Vem desligada por padrão. Marque os parceiros que devem receber cópia
das conversas que não são deles.
6
Salve e confira
Chame GET /routing e veja se o papel
da D-API é o esperado.
3. Casos de uso
D-API como fallback
Dividir por entrada
Bot e humano
Voltar a usar só a D-API
Cenário. O cliente usa outra plataforma no dia a dia e quer a D-API
pronta para assumir se ela falhar, sem interferir no funcionamento dela.Configuração no Meta Business Suite:
Item
Valor
Principal de todas as entradas
Outro parceiro
Escalonamento
D-API
Standby
D-API
Resultado em GET /routing:situation: "routed", roles: ["escalation"],
isStandby: true.No dia a dia:
O outro parceiro recebe e responde tudo, normalmente.
A D-API recebe cópia de tudo pelo webhook, com is_standby: true:
mensagens do cliente e o que o outro parceiro enviou (fromMe: true).
O histórico fica completo no painel.
Flows, automações e agentes de IA da D-API não disparam nessas
cópias.
A D-API pode enviar templates quando quiser.
Quando a outra plataforma cair, a D-API assume a conversa de duas formas:
Implícita: envie uma mensagem normal pela D-API. A Meta transfere a
conversa na hora, e o outro parceiro recebe o aviso de que perdeu a
conversa.
Depois de assumir, as próximas mensagens daquele cliente chegam à D-API
como mensagens normais (sem is_standby), e flows e automações voltam a
funcionar nela.Para devolver a conversa ao outro parceiro, use
pass com targetRole: "customer_service", ou
release para deixar a próxima mensagem do cliente
decidir pela configuração.
Como a D-API é o parceiro de escalonamento, qualquer mensagem de
atendimento enviada por ela (pela API, pelo painel, por um flow
agendado) assume a conversa do outro parceiro. Se a sua integração não
deve assumir conversas, envie apenas templates enquanto a outra
plataforma estiver no ar.
Cenário. A D-API dispara campanhas e notificações; o outro parceiro faz
o atendimento.Configuração:
Entrada
Principal
Resposta a template de marketing
Rotear para quem enviou
Resposta a template de utilidade
Rotear para quem enviou
Atendimento
Outro parceiro
Anúncio de clique para WhatsApp
Outro parceiro
Resultado: quem responde a um template da D-API conversa com a D-API
(flows de resposta funcionam). Quem chega por anúncio ou escreve do nada vai
para o atendimento do outro parceiro.Se quiser que a D-API acompanhe o atendimento do outro parceiro, dê a ela
também a visão standby.
Cenário. Um parceiro faz o primeiro atendimento com bot e outro (ou a
D-API) atende quando o cliente pede um humano.Configuração: o bot é principal de Atendimento; quem faz o
atendimento humano é o escalonamento.Operação: quando o cliente pede um humano, o bot faz um pass sem
targetRole (vai direto para o escalonamento). Se o bot for a D-API:
O texto de metadata chega ao parceiro que recebe a conversa.
Duas formas:
Remover o outro parceiro da conta. Com menos de dois parceiros, a Meta
apaga o roteamento sozinha e tudo volta a chegar normalmente na D-API.
GET /routing passa a mostrar situation: "exclusive".
Manter os dois e tornar a D-API principal de todas as entradas. O
outro parceiro continua conectado, mas não recebe mais conversas (a não
ser que também tenha escalonamento ou standby).
Nos dois casos a mudança é feita pela empresa no Meta Business Suite.
4. Trocar o dono de uma conversa
Uma rota, três ações. Sempre para uma conversa (um cliente).
POST /api/v1/connections/cloud-api/{id}/thread-control
string
obrigatório
take, pass ou release.
string
obrigatório
Telefone do cliente. Aceita qualquer formatação ou JID
(5551999999999@s.whatsapp.net).
string
Só com pass. Para qual entrada entregar: customer_service, ctwa,
marketing, utility, escalation ou ai_agent (Meta Business Agent, se
ativo na conta). Sem ele, o pass vai para o parceiro de escalonamento.
string
Texto livre, até 2000 caracteres, entregue ao parceiro que recebe a conversa.
Assumir (take)
A D-API toma a conversa de quem for o dono. Só funciona se a D-API for o
parceiro de escalonamento.
O pass é recusado se a conversa estiver livre, se a D-API não for a dona, se a
entrada escolhida não tiver principal ou se o destino já for o dono.
Soltar (release)
A D-API, sendo a dona, deixa a conversa livre. A próxima mensagem do
cliente é roteada de novo pela configuração da empresa. Soltar uma conversa que
já está livre não dá erro.
O releasenão gera webhook para ninguém: não há novo dono até o cliente
escrever de novo.
Erros
HTTP
code
Quando
400
INVALID_INPUT
to sem telefone, targetRole fora de pass, metadata maior que 2000 caracteres.
403
NOT_ESCALATION_PARTNER
take sem a D-API ser o parceiro de escalonamento.
400
THREAD_CONTROL_NOT_ENABLED
O número não tem roteamento ou a empresa não aceitou os termos.
400
ACTION_NOT_ENABLED
A ação ou o destino não está habilitado na conta (ex.: ai_agent sem Meta Business Agent).
400
META_GRAPH_ERROR
Outra recusa da Meta (ex.: pass sem ser dono). data.metaCode traz o código da Meta.
404
—
Conexão não encontrada.
Exemplo de erro
{ "success": false, "error": "You are not permitted to take thread control for this phone number.", "code": "NOT_ESCALATION_PARTNER", "data": { "metaCode": 2494191, "fbtraceId": "AbCdEf123" }}
5. Webhooks
Modo normalized
Modo meta_passthrough
Cópias de conversas de outros parceiros: is_standby
As cópias chegam nos mesmos eventos de sempre, com um campo a mais:
is_standby: true. Nas mensagens normais o campo não aparece.
O que aconteceu
Evento
Campos que mudam
O cliente escreveu numa conversa de outro parceiro
messages.received
fromMe: false, is_standby: true
O outro parceiro enviou uma mensagem ao cliente
messages.received
fromMe: true, is_standby: true
Uma mensagem do outro parceiro foi entregue, lida ou falhou
Templates enviados pelo outro parceiro chegam com type: "template" e o
texto [Template nome]: parâmetros em message. Mensagens interativas
chegam com type: "interactive" e o texto do corpo.
Não responda mensagens com is_standby: true. A conversa é de outro
parceiro: a resposta é recusada com 131070 ou, se a D-API for o
escalonamento, toma a conversa do outro parceiro.
Troca de dono: conversation.control_changed
Disparado quando uma conversa muda de dono envolvendo a D-API:
type: "control_passed": outro parceiro entregou a conversa à D-API.
A D-API agora é a dona (is_owner: true).
type: "control_taken": o parceiro de escalonamento tomou a conversa da
D-API. A D-API deixou de ser dona (is_owner: false).
true: a D-API passou a ser a dona da conversa. false: deixou de ser.
string | null
Papel de quem era o dono (customer_service, ctwa, marketing,
utility, escalation, ai_agent).
string | null
Papel de quem passou a ser o dono.
string | null
Texto enviado por quem fez a troca.
string | null
Resumo da conversa gerado pela Meta, quando ela envia (só em
control_passed).
No modo meta_passthrough a D-API repassa o payload da Meta sem
alterações, como em todos os outros eventos:
Cópias chegam no campo standby (change.field === "standby"), com o
conteúdo em value.standby.messages, value.standby.message_echoes ou
value.standby.statuses.
Trocas de dono chegam no campo messaging_handovers
(value.type = control_passed ou control_taken).
6. Envio numa conversa de outro parceiro: erro 131070
Se a D-API tentar enviar texto livre ou mídia numa conversa que não é dela (e
não for o escalonamento), a Meta recusa. A rota de envio responde:
{ "success": false, "error": "Failed to send message", "message": "Conversa controlada por outro app (Meta 131070). Este número usa Conversation Routing e outro parceiro é o dono desta conversa. Envie um template (permitido sempre), peça ao dono um pass, ou chame POST /api/v1/connections/cloud-api/{id}/thread-control com action=take se a D-API for o parceiro de escalonamento."}
O que fazer:
Precisa falar com o cliente agora? Envie um template.
A D-API é o escalonamento? Assuma com take (ou o próprio envio já
assume, sem erro).
Senão, peça ao parceiro dono um pass para a D-API, ou mude a
configuração no Meta Business Suite.
Conversa livre (sem dono) também recusa texto livre: a próxima mensagem
do cliente é que define o dono. Para puxar uma conversa livre, envie um
template de marketing ou utilidade: se a empresa configurou essa entrada como
“Rotear para quem enviou”, a resposta do cliente traz a conversa para a D-API.
Perguntas frequentes
A D-API fica sempre em standby?
Não. O papel da D-API é o que a empresa configurou no Meta Business Suite,
e pode ser diferente por número. A empresa pode mudar quando quiser:
tornar a D-API principal de uma ou de todas as entradas, tirar o standby,
ou remover o outro parceiro (aí o roteamento some e tudo volta ao normal).
Use GET /routing para ver o papel
atual.
Dá para usar as duas plataformas ao mesmo tempo?
Sim, no mesmo número e ao mesmo tempo, mas não na mesma conversa ao mesmo
tempo: cada conversa tem um dono. As duas podem enviar templates
livremente.
Como sei se tem outro parceiro no número?
GET /routing: otherAppsCount maior que zero e a lista em
subscribedApps.
Os flows e as automações da D-API rodam nas cópias standby?
Não. Cópias com is_standby: true vão para o histórico e para o webhook,
mas não disparam flows, automações nem agentes de IA. Eles voltam a rodar
quando a D-API vira dona da conversa.
As mensagens do outro parceiro aparecem no painel da D-API?
Sim, quando a D-API tem a visão standby: as mensagens do cliente e as
respostas do outro parceiro entram no histórico da conversa.
Eu pago pelas mensagens do outro parceiro?
Não. Mensagens enviadas pelo outro parceiro não entram na cobrança da D-API.
A cobrança da Meta por template é de quem enviou.
E a integração com a Datacrazy?
As cópias standby não são repassadas à Datacrazy: o formato dela não
tem como marcar que a mensagem é só uma cópia, e a automação de lá
responderia uma conversa que não é da D-API.
Quanto tempo uma conversa fica com o mesmo dono?
Até ser entregue, solta ou assumida, ou até 24h sem mensagem do
cliente. Depois disso ela fica livre, e a próxima mensagem do cliente
escolhe o dono de novo pela entrada.
Ao conectar a D-API num número que já usa outro parceiro, algo muda para ele?
A D-API não registra de novo um número que já está ativo na API Oficial
com outro parceiro, para não trocar a verificação em duas etapas que ele
configurou. Mas a Meta pode criar uma configuração de roteamento
automática quando o segundo parceiro entra. Depois de conectar, confira a
configuração no Meta Business Suite.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"D-API","colors":{"primary":"#00B7CD","light":"#2DD4E0","dark":"#0E8FA3"},"logo":{"light":"https://mintcdn.com/d-api/dcX-Hd4-QsKLE866/logo/dapi-horizontal.png?fit=max\u0026auto=format\u0026n=dcX-Hd4-QsKLE866\u0026q=85\u0026s=449901bb5b53e11232d03fd1fa54a4c3","dark":"https://mintcdn.com/d-api/dcX-Hd4-QsKLE866/logo/dapi-horizontal.png?fit=max\u0026auto=format\u0026n=dcX-Hd4-QsKLE866\u0026q=85\u0026s=449901bb5b53e11232d03fd1fa54a4c3"},"favicon":"https://mintcdn.com/d-api/dcX-Hd4-QsKLE866/favicon.png?fit=max\u0026auto=format\u0026n=dcX-Hd4-QsKLE866\u0026q=85\u0026s=a2b2d31d3ad7ea89d6d82db7f17b2b07","navbar":{"links":[{"href":"https://wa.me/5551920018823?text=Ol%C3%A1%2C%20preciso%20de%20ajuda%20com%20a%20documenta%C3%A7%C3%A3o%20da%20D-API","label":"Suporte"}],"primary":{"type":"button","label":"Painel","href":"https://app.d-api.cloud"}},"footer":{"links":[{"header":"D-API","items":[{"label":"Painel","href":"https://app.d-api.cloud"},{"label":"Suporte","href":"https://wa.me/5551920018823?text=Ol%C3%A1%2C%20preciso%20de%20ajuda%20com%20a%20documenta%C3%A7%C3%A3o%20da%20D-API"}]}]},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"pt-BR","default":true,"href":"whatsapp/introducao"},{"language":"en","footer":{"links":[{"header":"D-API","items":[{"label":"Dashboard","href":"https://app.d-api.cloud"},{"label":"Support","href":"https://wa.me/5551920018823?text=Hi%2C%20I%20need%20help%20with%20the%20D-API%20documentation"}]}]},"navbar":{"links":[{"href":"https://wa.me/5551920018823?text=Hi%2C%20I%20need%20help%20with%20the%20D-API%20documentation","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.d-api.cloud"}},"href":"en/whatsapp/introducao"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"d-api","hasAudioNarration":false,"actualSubdomain":"d-api","customDomains":["docs.d-api.cloud"],"gitSource":{"type":"github","owner":"joaoartur","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6af87e0a4fd4397144dfd711","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"pt-BR","tag":"API Reference","count":140},{"language":"en","tag":"API Reference","count":140},{"language":"pt-BR","tag":"Sessões","count":27},{"language":"en","tag":"Sessions","count":27},{"language":"pt-BR","tag":"Ligações","count":17},{"language":"pt-BR","tag":"WhatsApp","count":17},{"language":"en","tag":"Calls","count":17},{"language":"en","tag":"WhatsApp","count":17},{"language":"pt-BR","tag":"Grupos","count":15},{"language":"pt-BR","tag":"Conversas","count":15},{"language":"en","tag":"Groups","count":15},{"language":"en","tag":"Chats","count":15},{"language":"pt-BR","tag":"Webhooks","count":14},{"language":"en","tag":"Webhooks","count":14},{"language":"pt-BR","tag":"API Oficial (Cloud API)","count":11},{"language":"pt-BR","tag":"Mensagens","count":11},{"language":"en","tag":"Official API (Cloud API)","count":11},{"language":"en","tag":"Messages","count":11},{"language":"pt-BR","tag":"Catálogo","count":9},{"language":"en","tag":"Catalog","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-oficial/multiplos-parceiros","slug":"/api-oficial/multiplos-parceiros","pageMetadata":{"title":"Vários parceiros no mesmo número","description":"Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.","href":"/api-oficial/multiplos-parceiros"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Info,Note,ParamField,ResponseField,Step,Steps,Tab,Table,Tabs,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Um número da `,_jsx(_components.strong,{children:`API Oficial`}),` (Cloud API) pode estar conectado a `,_jsx(_components.strong,{children:`mais de uma\nplataforma ao mesmo tempo`}),`: a D-API e um CRM, um chatbot, outra API. Na Meta,\ncada plataforma é um `,_jsx(_components.strong,{children:`parceiro`}),` (um app). Esta página explica como os dois\nconvivem sem um atrapalhar o outro.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Resumo em três frases.`}),` Os dois parceiros podem estar no número ao mesmo\ntempo, mas `,_jsx(_components.strong,{children:`cada conversa tem um único dono`}),` que responde. Quem decide quem é\ndono de quê é `,_jsx(_components.strong,{children:`a empresa dona do número`}),`, no Meta Business Suite. A D-API\nmostra o papel dela, recebe cópia das conversas dos outros (standby) e, quando\nautorizada, `,_jsx(_components.strong,{children:`assume uma conversa a qualquer momento`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`por-que-isso-existe`,children:`Por que isso existe`}),`\n`,_jsxs(_components.p,{children:[`Sem nenhuma regra, todo parceiro conectado recebe `,_jsx(_components.strong,{children:`todas`}),` as mensagens e todos\npodem responder. Na prática isso vira bagunça: dois robôs respondendo o mesmo\ncliente, ou um parceiro respondendo uma conversa que o outro estava atendendo.`]}),`\n`,_jsxs(_components.p,{children:[`A Meta resolveu isso com o `,_jsx(_components.strong,{children:`Conversation Routing`}),` (roteamento de conversas):\na empresa define qual parceiro atende cada tipo de conversa, e a Meta entrega a\nmensagem só para ele.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Quando um segundo parceiro entra na conta, a Meta `,_jsx(_components.strong,{children:`pode criar uma\nconfiguração de roteamento automaticamente`}),`, a partir dos parceiros que já\nestavam lá. Se a D-API (ou o outro parceiro) parou de receber mensagens ou\npassou a receber o erro `,_jsx(_components.code,{children:`131070`}),` logo depois de uma nova conexão, é isso.\nConfira a configuração no Meta Business Suite e o\n`,_jsx(_components.a,{href:`#1-descubra-a-situa%C3%A7%C3%A3o-do-n%C3%BAmero`,children:`papel da D-API`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`conceitos`,children:`Conceitos`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Termo`}),_jsx(_components.th,{children:`O que é`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Conversa`})}),_jsxs(_components.td,{children:[`A troca de mensagens com `,_jsx(_components.strong,{children:`um`}),` cliente num número. O roteamento vale por conversa, não pelo número inteiro: o mesmo número pode ter conversas com donos diferentes.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Dono`})}),_jsxs(_components.td,{children:[`O parceiro que atende aquela conversa. É o `,_jsx(_components.strong,{children:`único`}),` que recebe a mensagem do cliente como mensagem normal e o `,_jsx(_components.strong,{children:`único`}),` que pode enviar mensagem de atendimento (texto livre na janela de 24h).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Entrada`})}),_jsxs(_components.td,{children:[`Por onde a conversa começou. Define quem vira dono. São cinco: `,_jsx(_components.strong,{children:`Atendimento`}),` (padrão), `,_jsx(_components.strong,{children:`Anúncio de clique para WhatsApp`}),`, `,_jsx(_components.strong,{children:`Resposta a template de marketing`}),`, `,_jsx(_components.strong,{children:`Resposta a template de utilidade`}),` e `,_jsx(_components.strong,{children:`Ligação`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Principal`})}),_jsx(_components.td,{children:`O parceiro configurado para uma entrada. Vira dono quando a conversa começa por ela.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Standby`})}),_jsxs(_components.td,{children:[`O parceiro `,_jsx(_components.strong,{children:`observador`}),`: recebe `,_jsx(_components.strong,{children:`cópia`}),` de tudo que acontece nas conversas dos outros (mensagens do cliente, o que o dono enviou e status), mas `,_jsx(_components.strong,{children:`não responde`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Escalonamento`})}),_jsxs(_components.td,{children:[`No máximo `,_jsx(_components.strong,{children:`um`}),` parceiro por conta. Pode `,_jsx(_components.strong,{children:`assumir qualquer conversa a qualquer momento`}),`, mesmo com outro dono. É o que torna possível o fallback.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Conversa livre`})}),_jsxs(_components.td,{children:[`Sem dono. Acontece depois de `,_jsx(_components.strong,{children:`24h sem mensagem do cliente`}),` ou quando o dono solta a conversa. A próxima mensagem do cliente decide o dono de novo, pela entrada.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`o-que-cada-parceiro-pode-fazer`,children:`O que cada parceiro pode fazer`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Dono da conversa`}),_jsx(_components.th,{children:`Standby`}),_jsx(_components.th,{children:`Escalonamento (sem ser dono)`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Recebe a mensagem do cliente`}),_jsx(_components.td,{children:`Sim`}),_jsxs(_components.td,{children:[`Cópia, marcada com `,_jsx(_components.code,{children:`is_standby`})]}),_jsx(_components.td,{children:`Só se também for standby`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Envia texto livre / mídia`}),_jsx(_components.td,{children:`Sim`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Não`}),` (erro `,_jsx(_components.code,{children:`131070`}),`)`]}),_jsxs(_components.td,{children:[`Sim, e `,_jsx(_components.strong,{children:`vira dono`}),` ao enviar`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Envia template (marketing, utilidade, autenticação)`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sim`})}),_jsx(_components.td,{children:`Sim`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Assume a conversa (`,_jsx(_components.code,{children:`take`}),`)`]}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Não`}),_jsx(_components.td,{children:`Sim`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Entrega a conversa (`,_jsx(_components.code,{children:`pass`}),`) ou solta (`,_jsx(_components.code,{children:`release`}),`)`]}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Não`}),_jsx(_components.td,{children:`Não (precisa assumir antes)`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Templates sempre podem ser enviados`}),`, por qualquer parceiro, sendo dono ou\nnão. Enviar um template `,_jsx(_components.strong,{children:`não`}),` muda o dono da conversa. O que pode mudar é a\nresposta do cliente: se ele tocar num botão do template, a conversa é\nroteada de novo pela entrada de marketing/utilidade.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`1-descubra-a-situação-do-número`,children:`1. Descubra a situação do número`}),`\n`,_jsx(_components.p,{children:`Uma chamada mostra se há outros parceiros e qual é o papel da D-API:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.d-api.cloud/api/v1/connections/cloud-api/SUA_CONEXAO/routing`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: SUA_API_KEY\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`SUA_CONEXAO`}),` é o id da conexão ou o id da sessão (`,_jsx(_components.code,{children:`cloud-…`}),`).`]}),`\n`,_jsx(CodeBlock,{filename:`Resposta`,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"situation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"routed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"routingEnabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"roles\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"escalation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isStandby\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isEscalation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subscribedApps\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"D-API\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"isCurrentApp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"9876543210\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Outro CRM\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"isCurrentApp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"otherAppsCount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(ResponseField,{name:`situation`,type:`string`,id:`param-situation`,children:[_jsx(_components.p,{children:`O resumo. Um de três valores:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`exclusive`}),`: só a D-API está na conta. Tudo funciona como sempre.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`shared_without_routing`}),`: há outro parceiro e `,_jsx(_components.strong,{children:`nenhum roteamento`}),`. Os\ndois recebem todas as mensagens e os dois podem responder. Configure o\nroteamento para evitar respostas duplicadas.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`routed`}),`: o roteamento está ativo. O que a D-API faz depende de `,_jsx(_components.code,{children:`roles`}),` e\n`,_jsx(_components.code,{children:`isStandby`}),`.`]}),`\n`]})]}),`\n`,_jsx(ResponseField,{name:`roles`,type:`string[]`,id:`param-roles`,children:_jsxs(_components.p,{children:[`Entradas em que a D-API é a principal: `,_jsx(_components.code,{children:`customer_service`}),` (atendimento),\n`,_jsx(_components.code,{children:`ctwa`}),` (anúncio de clique para WhatsApp), `,_jsx(_components.code,{children:`marketing`}),`, `,_jsx(_components.code,{children:`utility`}),`, `,_jsx(_components.code,{children:`calls`}),`\n(ligações). Contém `,_jsx(_components.code,{children:`escalation`}),` se a D-API é o parceiro de escalonamento.\nVazio quando a D-API não é principal de nada.`]})}),`\n`,_jsx(ResponseField,{name:`isStandby`,type:`boolean`,id:`param-is-standby`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` se a empresa deu à D-API a visão standby (cópia das conversas dos\noutros parceiros).`]})}),`\n`,_jsx(ResponseField,{name:`isEscalation`,type:`boolean`,id:`param-is-escalation`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` se a D-API pode assumir qualquer conversa. Atalho para `,_jsx(_components.code,{children:`roles`}),` conter\n`,_jsx(_components.code,{children:`escalation`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`subscribedApps`,type:`object[]`,id:`param-subscribed-apps`,children:_jsxs(_components.p,{children:[`Parceiros (apps) conectados à conta. `,_jsx(_components.code,{children:`isCurrentApp: true`}),` marca a D-API.`]})}),`\n`,_jsx(ResponseField,{name:`otherAppsCount`,type:`number`,id:`param-other-apps-count`,children:_jsx(_components.p,{children:`Quantos parceiros além da D-API.`})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Esta rota consulta a Meta na hora, e a Meta limita a frequência. Use em telas\nde configuração ou depois de um erro `,_jsx(_components.code,{children:`131070`}),`. `,_jsx(_components.strong,{children:`Não chame antes de cada\nenvio.`})]})}),`\n`,_jsx(Heading,{level:`2`,id:`2-configure-o-roteamento-no-meta-business-suite`,children:`2. Configure o roteamento no Meta Business Suite`}),`\n`,_jsxs(_components.p,{children:[`A configuração é `,_jsx(_components.strong,{children:`da empresa dona do número`}),` e só existe na interface da\nMeta. Nenhum parceiro (nem a D-API) consegue configurar por API.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Aceite os termos`,children:_jsxs(_components.p,{children:[`Standby, escalonamento e troca de dono exigem que a empresa aceite os\n`,_jsx(_components.strong,{children:`Termos de Serviço de Meta Business Agents e da Plataforma`}),`. Sem isso,\nsó o roteamento básico funciona.`]})}),_jsx(Step,{title:`Abra o roteamento de conversas`,children:_jsxs(_components.p,{children:[`No `,_jsx(_components.strong,{children:`Meta Business Suite`}),`, abra as configurações da conta do WhatsApp e\nprocure `,_jsx(_components.strong,{children:`Roteamento de conversas`}),` (`,_jsx(_components.em,{children:`Conversation Routing`}),`). Dá para\nconfigurar a conta inteira ou um número específico (a configuração do\nnúmero tem prioridade).`]})}),_jsx(Step,{title:`Escolha o principal de cada entrada`,children:_jsxs(_components.p,{children:[`Para cada uma das cinco entradas, escolha o parceiro que atende. Em\nmarketing e utilidade existe a opção `,_jsx(_components.strong,{children:`“Rotear para quem enviou”`}),`: a\nresposta do cliente vai para o parceiro que enviou o template.`]})}),_jsx(Step,{title:`Escolha o parceiro de escalonamento (opcional)`,children:_jsx(_components.p,{children:`No máximo um. Ele pode assumir qualquer conversa.`})}),_jsx(Step,{title:`Dê a visão standby (opcional)`,children:_jsxs(_components.p,{children:[`Vem `,_jsx(_components.strong,{children:`desligada`}),` por padrão. Marque os parceiros que devem receber cópia\ndas conversas que não são deles.`]})}),_jsx(Step,{title:`Salve e confira`,children:_jsxs(_components.p,{children:[`Chame `,_jsx(_components.a,{href:`#1-descubra-a-situa%C3%A7%C3%A3o-do-n%C3%BAmero`,children:_jsx(_components.code,{children:`GET /routing`})}),` e veja se o papel\nda D-API é o esperado.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`3-casos-de-uso`,children:`3. Casos de uso`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`D-API como fallback`,id:`d-api-como-fallback`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cenário.`}),` O cliente usa outra plataforma no dia a dia e quer a D-API\npronta para assumir se ela falhar, `,_jsx(_components.strong,{children:`sem interferir`}),` no funcionamento dela.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Configuração no Meta Business Suite:`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Item`}),_jsx(_components.th,{children:`Valor`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Principal de todas as entradas`}),_jsx(_components.td,{children:`Outro parceiro`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Escalonamento`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`D-API`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Standby`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`D-API`})})]})]})]}),_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Resultado em `,_jsx(_components.code,{children:`GET /routing`}),`:`]}),` `,_jsx(_components.code,{children:`situation: \"routed\"`}),`, `,_jsx(_components.code,{children:`roles: [\"escalation\"]`}),`,\n`,_jsx(_components.code,{children:`isStandby: true`}),`.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`No dia a dia:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`O outro parceiro recebe e responde tudo, normalmente.`}),`\n`,_jsxs(_components.li,{children:[`A D-API recebe `,_jsx(_components.strong,{children:`cópia`}),` de tudo pelo webhook, com `,_jsx(_components.code,{children:`is_standby: true`}),`:\nmensagens do cliente e o que o outro parceiro enviou (`,_jsx(_components.code,{children:`fromMe: true`}),`).\nO histórico fica completo no painel.`]}),`\n`,_jsxs(_components.li,{children:[`Flows, automações e agentes de IA da D-API `,_jsx(_components.strong,{children:`não disparam`}),` nessas\ncópias.`]}),`\n`,_jsxs(_components.li,{children:[`A D-API pode enviar `,_jsx(_components.strong,{children:`templates`}),` quando quiser.`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Quando a outra plataforma cair`}),`, a D-API assume a conversa de duas formas:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Explícita:`}),` chame `,_jsx(_components.a,{href:`#assumir-take`,children:_jsx(_components.code,{children:`take`})}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Implícita:`}),` envie uma mensagem normal pela D-API. A Meta transfere a\nconversa na hora, e o outro parceiro recebe o aviso de que perdeu a\nconversa.`]}),`\n`]}),_jsxs(_components.p,{children:[`Depois de assumir, as próximas mensagens daquele cliente chegam à D-API\ncomo mensagens normais (sem `,_jsx(_components.code,{children:`is_standby`}),`), e flows e automações voltam a\nfuncionar nela.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para devolver`}),` a conversa ao outro parceiro, use\n`,_jsx(_components.a,{href:`#entregar-pass`,children:_jsx(_components.code,{children:`pass`})}),` com `,_jsx(_components.code,{children:`targetRole: \"customer_service\"`}),`, ou\n`,_jsx(_components.a,{href:`#soltar-release`,children:_jsx(_components.code,{children:`release`})}),` para deixar a próxima mensagem do cliente\ndecidir pela configuração.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Como a D-API é o parceiro de escalonamento, `,_jsx(_components.strong,{children:`qualquer`}),` mensagem de\natendimento enviada por ela (pela API, pelo painel, por um flow\nagendado) assume a conversa do outro parceiro. Se a sua integração não\ndeve assumir conversas, envie apenas templates enquanto a outra\nplataforma estiver no ar.`]})})]}),_jsxs(Tab,{title:`Dividir por entrada`,id:`dividir-por-entrada`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cenário.`}),` A D-API dispara campanhas e notificações; o outro parceiro faz\no atendimento.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Configuração:`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Entrada`}),_jsx(_components.th,{children:`Principal`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Resposta a template de marketing`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Rotear para quem enviou`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Resposta a template de utilidade`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Rotear para quem enviou`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Atendimento`}),_jsx(_components.td,{children:`Outro parceiro`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Anúncio de clique para WhatsApp`}),_jsx(_components.td,{children:`Outro parceiro`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Resultado:`}),` quem responde a um template da D-API conversa com a D-API\n(flows de resposta funcionam). Quem chega por anúncio ou escreve do nada vai\npara o atendimento do outro parceiro.`]}),_jsxs(_components.p,{children:[`Se quiser que a D-API acompanhe o atendimento do outro parceiro, dê a ela\ntambém a visão `,_jsx(_components.strong,{children:`standby`}),`.`]})]}),_jsxs(Tab,{title:`Bot e humano`,id:`bot-e-humano`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cenário.`}),` Um parceiro faz o primeiro atendimento com bot e outro (ou a\nD-API) atende quando o cliente pede um humano.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Configuração:`}),` o bot é principal de `,_jsx(_components.strong,{children:`Atendimento`}),`; quem faz o\natendimento humano é o `,_jsx(_components.strong,{children:`escalonamento`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Operação:`}),` quando o cliente pede um humano, o bot faz um `,_jsx(_components.code,{children:`pass`}),` sem\n`,_jsx(_components.code,{children:`targetRole`}),` (vai direto para o escalonamento). Se o bot for a D-API:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.d-api.cloud/api/v1/connections/cloud-api/SUA_CONEXAO/thread-control`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: SUA_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"action\": \"pass\", \"to\": \"5551999999999\", \"metadata\": \"Cliente pediu atendente\" }'`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`O texto de `,_jsx(_components.code,{children:`metadata`}),` chega ao parceiro que recebe a conversa.`]})]}),_jsxs(Tab,{title:`Voltar a usar só a D-API`,id:`voltar-a-usar-s%C3%B3-a-d-api`,children:[_jsx(_components.p,{children:`Duas formas:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Remover o outro parceiro da conta.`}),` Com menos de dois parceiros, a Meta\n`,_jsx(_components.strong,{children:`apaga o roteamento`}),` sozinha e tudo volta a chegar normalmente na D-API.\n`,_jsx(_components.code,{children:`GET /routing`}),` passa a mostrar `,_jsx(_components.code,{children:`situation: \"exclusive\"`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Manter os dois e tornar a D-API principal de todas as entradas.`}),` O\noutro parceiro continua conectado, mas não recebe mais conversas (a não\nser que também tenha escalonamento ou standby).`]}),`\n`]}),_jsx(_components.p,{children:`Nos dois casos a mudança é feita pela empresa no Meta Business Suite.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`4-trocar-o-dono-de-uma-conversa`,children:`4. Trocar o dono de uma conversa`}),`\n`,_jsxs(_components.p,{children:[`Uma rota, três ações. Sempre para `,_jsx(_components.strong,{children:`uma conversa`}),` (um cliente).`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /api/v1/connections/cloud-api/{id}/thread-control`})]}),`\n`]})})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`take`}),`, `,_jsx(_components.code,{children:`pass`}),` ou `,_jsx(_components.code,{children:`release`}),`.`]})}),`\n`,_jsx(ParamField,{body:`to`,type:`string`,required:true,id:`param-to`,children:_jsxs(_components.p,{children:[`Telefone do cliente. Aceita qualquer formatação ou JID\n(`,_jsx(_components.code,{children:`5551999999999@s.whatsapp.net`}),`).`]})}),`\n`,_jsx(ParamField,{body:`targetRole`,type:`string`,id:`param-target-role`,children:_jsxs(_components.p,{children:[`Só com `,_jsx(_components.code,{children:`pass`}),`. Para qual entrada entregar: `,_jsx(_components.code,{children:`customer_service`}),`, `,_jsx(_components.code,{children:`ctwa`}),`,\n`,_jsx(_components.code,{children:`marketing`}),`, `,_jsx(_components.code,{children:`utility`}),`, `,_jsx(_components.code,{children:`escalation`}),` ou `,_jsx(_components.code,{children:`ai_agent`}),` (Meta Business Agent, se\nativo na conta). Sem ele, o `,_jsx(_components.code,{children:`pass`}),` vai para o parceiro de escalonamento.`]})}),`\n`,_jsx(ParamField,{body:`metadata`,type:`string`,id:`param-metadata`,children:_jsx(_components.p,{children:`Texto livre, até 2000 caracteres, entregue ao parceiro que recebe a conversa.`})}),`\n`,_jsxs(Heading,{level:`3`,id:`assumir-take`,children:[`Assumir (`,_jsx(_components.code,{children:`take`}),`)`]}),`\n`,_jsxs(_components.p,{children:[`A D-API toma a conversa de quem for o dono. `,_jsx(_components.strong,{children:`Só funciona se a D-API for o\nparceiro de escalonamento.`})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.d-api.cloud/api/v1/connections/cloud-api/SUA_CONEXAO/thread-control`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: SUA_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"action\": \"take\", \"to\": \"5551999999999\" }'`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:`Resposta`,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"action\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"take\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"requestId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`O parceiro que perdeu a conversa é avisado pela Meta.`}),`\n`,_jsxs(Heading,{level:`3`,id:`entregar-pass`,children:[`Entregar (`,_jsx(_components.code,{children:`pass`}),`)`]}),`\n`,_jsxs(_components.p,{children:[`A D-API, `,_jsx(_components.strong,{children:`sendo a dona`}),`, entrega a conversa para outro parceiro.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.d-api.cloud/api/v1/connections/cloud-api/SUA_CONEXAO/thread-control`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: SUA_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"action\": \"pass\", \"to\": \"5551999999999\", \"targetRole\": \"customer_service\" }'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`O `,_jsx(_components.code,{children:`pass`}),` é recusado se a conversa estiver livre, se a D-API não for a dona, se a\nentrada escolhida não tiver principal ou se o destino já for o dono.`]}),`\n`,_jsxs(Heading,{level:`3`,id:`soltar-release`,children:[`Soltar (`,_jsx(_components.code,{children:`release`}),`)`]}),`\n`,_jsxs(_components.p,{children:[`A D-API, `,_jsx(_components.strong,{children:`sendo a dona`}),`, deixa a conversa livre. A próxima mensagem do\ncliente é roteada de novo pela configuração da empresa. Soltar uma conversa que\njá está livre não dá erro.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.d-api.cloud/api/v1/connections/cloud-api/SUA_CONEXAO/thread-control`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: SUA_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"action\": \"release\", \"to\": \"5551999999999\" }'`})]}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O `,_jsx(_components.code,{children:`release`}),` `,_jsx(_components.strong,{children:`não gera webhook`}),` para ninguém: não há novo dono até o cliente\nescrever de novo.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`erros`,children:`Erros`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.th,{children:`Quando`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_INPUT`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`to`}),` sem telefone, `,_jsx(_components.code,{children:`targetRole`}),` fora de `,_jsx(_components.code,{children:`pass`}),`, `,_jsx(_components.code,{children:`metadata`}),` maior que 2000 caracteres.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_ESCALATION_PARTNER`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`take`}),` sem a D-API ser o parceiro de escalonamento.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`THREAD_CONTROL_NOT_ENABLED`})}),_jsx(_components.td,{children:`O número não tem roteamento ou a empresa não aceitou os termos.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ACTION_NOT_ENABLED`})}),_jsxs(_components.td,{children:[`A ação ou o destino não está habilitado na conta (ex.: `,_jsx(_components.code,{children:`ai_agent`}),` sem Meta Business Agent).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`META_GRAPH_ERROR`})}),_jsxs(_components.td,{children:[`Outra recusa da Meta (ex.: `,_jsx(_components.code,{children:`pass`}),` sem ser dono). `,_jsx(_components.code,{children:`data.metaCode`}),` traz o código da Meta.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Conexão não encontrada.`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:`Exemplo de erro`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"You are not permitted to take thread control for this phone number.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NOT_ESCALATION_PARTNER\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"metaCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2494191`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"fbtraceId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AbCdEf123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`5-webhooks`,children:`5. Webhooks`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Modo normalized`,id:`modo-normalized`,\"data-child-heading-ids\":`[\"c%C3%B3pias-de-conversas-de-outros-parceiros%3A-is_standby\",\"troca-de-dono%3A-conversation-control_changed\"]`,children:[_jsxs(Heading,{level:`3`,id:`cópias-de-conversas-de-outros-parceiros-is_standby`,children:[`Cópias de conversas de outros parceiros: `,_jsx(_components.code,{children:`is_standby`})]}),_jsxs(_components.p,{children:[`As cópias chegam nos `,_jsx(_components.strong,{children:`mesmos eventos`}),` de sempre, com um campo a mais:\n`,_jsx(_components.code,{children:`is_standby: true`}),`. Nas mensagens normais o campo `,_jsx(_components.strong,{children:`não aparece`}),`.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`O que aconteceu`}),_jsx(_components.th,{children:`Evento`}),_jsx(_components.th,{children:`Campos que mudam`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`O cliente escreveu numa conversa de outro parceiro`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`messages.received`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`fromMe: false`}),`, `,_jsx(_components.code,{children:`is_standby: true`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`O outro parceiro enviou uma mensagem ao cliente`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`messages.received`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`fromMe: true`}),`, `,_jsx(_components.code,{children:`is_standby: true`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Uma mensagem do outro parceiro foi entregue, lida ou falhou`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`message.delivered`}),` / `,_jsx(_components.code,{children:`message.read`}),` / `,_jsx(_components.code,{children:`message.failed`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`is_standby: true`})})]})]})]}),_jsx(CodeBlock,{filename:`Cliente escreveu numa conversa do outro parceiro`,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"event\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"messages.received\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sessionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cloud-3f2a…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"wamid.HBgM…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"from\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"jid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5551999999999@s.whatsapp.net\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Maria\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"to\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"jid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5511955026302@s.whatsapp.net\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fromMe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Meu pedido ainda não chegou\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1761955200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_group\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_standby\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`O outro parceiro enviou um template`,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"event\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"messages.received\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sessionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cloud-3f2a…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"wamid.HBgN…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"from\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"jid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5511955026302@s.whatsapp.net\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"to\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"jid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5551999999999@s.whatsapp.net\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fromMe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[Template pedido_enviado]: Maria, #12345\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1761955260`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_group\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"template\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_standby\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Templates enviados pelo outro parceiro chegam com `,_jsx(_components.code,{children:`type: \"template\"`}),` e o\ntexto `,_jsx(_components.code,{children:`[Template nome]: parâmetros`}),` em `,_jsx(_components.code,{children:`message`}),`. Mensagens interativas\nchegam com `,_jsx(_components.code,{children:`type: \"interactive\"`}),` e o texto do corpo.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Não responda mensagens com `,_jsx(_components.code,{children:`is_standby: true`}),`.`]}),` A conversa é de outro\nparceiro: a resposta é recusada com `,_jsx(_components.code,{children:`131070`}),` ou, se a D-API for o\nescalonamento, `,_jsx(_components.strong,{children:`toma a conversa`}),` do outro parceiro.`]})}),_jsxs(Heading,{level:`3`,id:`troca-de-dono-conversation-control_changed`,children:[`Troca de dono: `,_jsx(_components.code,{children:`conversation.control_changed`})]}),_jsxs(_components.p,{children:[`Disparado quando uma conversa muda de dono `,_jsx(_components.strong,{children:`envolvendo a D-API`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`type: \"control_passed\"`}),`: outro parceiro entregou a conversa à D-API.\n`,_jsx(_components.strong,{children:`A D-API agora é a dona`}),` (`,_jsx(_components.code,{children:`is_owner: true`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`type: \"control_taken\"`}),`: o parceiro de escalonamento tomou a conversa da\nD-API. `,_jsx(_components.strong,{children:`A D-API deixou de ser dona`}),` (`,_jsx(_components.code,{children:`is_owner: false`}),`).`]}),`\n`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"event\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"conversation.control_changed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sessionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cloud-3f2a…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"control_passed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_owner\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"remote_jid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5551999999999@s.whatsapp.net\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5551999999999\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"previous_owner_role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"customer_service\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"new_owner_role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"escalation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"metadata\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Cliente pediu atendente\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"conversation_summary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Cliente quer trocar o tamanho do pedido #12345.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1761955320`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(ResponseField,{name:`type`,type:`string`,id:`param-type`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`control_passed`}),` ou `,_jsx(_components.code,{children:`control_taken`}),`.`]})}),_jsx(ResponseField,{name:`is_owner`,type:`boolean`,id:`param-is-owner`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),`: a D-API passou a ser a dona da conversa. `,_jsx(_components.code,{children:`false`}),`: deixou de ser.`]})}),_jsx(ResponseField,{name:`previous_owner_role`,type:`string | null`,id:`param-previous-owner-role`,children:_jsxs(_components.p,{children:[`Papel de quem era o dono (`,_jsx(_components.code,{children:`customer_service`}),`, `,_jsx(_components.code,{children:`ctwa`}),`, `,_jsx(_components.code,{children:`marketing`}),`,\n`,_jsx(_components.code,{children:`utility`}),`, `,_jsx(_components.code,{children:`escalation`}),`, `,_jsx(_components.code,{children:`ai_agent`}),`).`]})}),_jsx(ResponseField,{name:`new_owner_role`,type:`string | null`,id:`param-new-owner-role`,children:_jsx(_components.p,{children:`Papel de quem passou a ser o dono.`})}),_jsx(ResponseField,{name:`metadata`,type:`string | null`,id:`param-metadata-1`,children:_jsx(_components.p,{children:`Texto enviado por quem fez a troca.`})}),_jsx(ResponseField,{name:`conversation_summary`,type:`string | null`,id:`param-conversation-summary`,children:_jsxs(_components.p,{children:[`Resumo da conversa gerado pela Meta, quando ela envia (só em\n`,_jsx(_components.code,{children:`control_passed`}),`).`]})})]}),_jsxs(Tab,{title:`Modo meta_passthrough`,id:`modo-meta_passthrough`,children:[_jsxs(_components.p,{children:[`No modo `,_jsx(_components.code,{children:`meta_passthrough`}),` a D-API repassa o payload da Meta `,_jsx(_components.strong,{children:`sem\nalterações`}),`, como em todos os outros eventos:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Cópias chegam no campo `,_jsx(_components.code,{children:`standby`}),` (`,_jsx(_components.code,{children:`change.field === \"standby\"`}),`), com o\nconteúdo em `,_jsx(_components.code,{children:`value.standby.messages`}),`, `,_jsx(_components.code,{children:`value.standby.message_echoes`}),` ou\n`,_jsx(_components.code,{children:`value.standby.statuses`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Trocas de dono chegam no campo `,_jsx(_components.code,{children:`messaging_handovers`}),`\n(`,_jsx(_components.code,{children:`value.type`}),` = `,_jsx(_components.code,{children:`control_passed`}),` ou `,_jsx(_components.code,{children:`control_taken`}),`).`]}),`\n`]}),_jsxs(_components.p,{children:[`Veja o formato completo na documentação da Meta:\n`,_jsx(_components.a,{href:`https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/standby/`,children:`standby`}),`\ne `,_jsx(_components.a,{href:`https://developers.facebook.com/documentation/business-messaging/whatsapp/conversation-routing/thread-control/`,children:`thread control`}),`.`]})]})]}),`\n`,_jsxs(Heading,{level:`2`,id:`6-envio-numa-conversa-de-outro-parceiro-erro-131070`,children:[`6. Envio numa conversa de outro parceiro: erro `,_jsx(_components.code,{children:`131070`})]}),`\n`,_jsx(_components.p,{children:`Se a D-API tentar enviar texto livre ou mídia numa conversa que não é dela (e\nnão for o escalonamento), a Meta recusa. A rota de envio responde:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Failed to send message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Conversa controlada por outro app (Meta 131070). Este número usa Conversation Routing e outro parceiro é o dono desta conversa. Envie um template (permitido sempre), peça ao dono um pass, ou chame POST /api/v1/connections/cloud-api/{id}/thread-control com action=take se a D-API for o parceiro de escalonamento.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`O que fazer:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Precisa falar com o cliente agora?`}),` Envie um `,_jsx(_components.strong,{children:`template`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A D-API é o escalonamento?`}),` Assuma com `,_jsx(_components.code,{children:`take`}),` (ou o próprio envio já\nassume, sem erro).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Senão`}),`, peça ao parceiro dono um `,_jsx(_components.code,{children:`pass`}),` para a D-API, ou mude a\nconfiguração no Meta Business Suite.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Conversa `,_jsx(_components.strong,{children:`livre`}),` (sem dono) também recusa texto livre: a próxima mensagem\ndo cliente é que define o dono. Para puxar uma conversa livre, envie um\ntemplate de marketing ou utilidade: se a empresa configurou essa entrada como\n“Rotear para quem enviou”, a resposta do cliente traz a conversa para a D-API.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`perguntas-frequentes`,children:`Perguntas frequentes`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`A D-API fica sempre em standby?`,id:`a-d-api-fica-sempre-em-standby`,children:_jsxs(_components.p,{children:[`Não. O papel da D-API é o que a empresa configurou no Meta Business Suite,\ne pode ser diferente por número. A empresa pode mudar quando quiser:\ntornar a D-API principal de uma ou de todas as entradas, tirar o standby,\nou remover o outro parceiro (aí o roteamento some e tudo volta ao normal).\nUse `,_jsx(_components.a,{href:`#1-descubra-a-situa%C3%A7%C3%A3o-do-n%C3%BAmero`,children:_jsx(_components.code,{children:`GET /routing`})}),` para ver o papel\natual.`]})}),_jsx(Accordion,{title:`Dá para usar as duas plataformas ao mesmo tempo?`,id:`da-para-usar-as-duas-plataformas-ao-mesmo-tempo`,children:_jsxs(_components.p,{children:[`Sim, no mesmo número e ao mesmo tempo, mas `,_jsx(_components.strong,{children:`não na mesma conversa ao mesmo\ntempo`}),`: cada conversa tem um dono. As duas podem enviar templates\nlivremente.`]})}),_jsx(Accordion,{title:`Como sei se tem outro parceiro no número?`,id:`como-sei-se-tem-outro-parceiro-no-numero`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /routing`}),`: `,_jsx(_components.code,{children:`otherAppsCount`}),` maior que zero e a lista em\n`,_jsx(_components.code,{children:`subscribedApps`}),`.`]})}),_jsx(Accordion,{title:`Os flows e as automações da D-API rodam nas cópias standby?`,id:`os-flows-e-as-automacoes-da-d-api-rodam-nas-copias-standby`,children:_jsxs(_components.p,{children:[`Não. Cópias com `,_jsx(_components.code,{children:`is_standby: true`}),` vão para o histórico e para o webhook,\nmas não disparam flows, automações nem agentes de IA. Eles voltam a rodar\nquando a D-API vira dona da conversa.`]})}),_jsx(Accordion,{title:`As mensagens do outro parceiro aparecem no painel da D-API?`,id:`as-mensagens-do-outro-parceiro-aparecem-no-painel-da-d-api`,children:_jsx(_components.p,{children:`Sim, quando a D-API tem a visão standby: as mensagens do cliente e as\nrespostas do outro parceiro entram no histórico da conversa.`})}),_jsx(Accordion,{title:`Eu pago pelas mensagens do outro parceiro?`,id:`eu-pago-pelas-mensagens-do-outro-parceiro`,children:_jsx(_components.p,{children:`Não. Mensagens enviadas pelo outro parceiro não entram na cobrança da D-API.\nA cobrança da Meta por template é de quem enviou.`})}),_jsx(Accordion,{title:`E a integração com a Datacrazy?`,id:`e-a-integracao-com-a-datacrazy`,children:_jsxs(_components.p,{children:[`As cópias standby `,_jsx(_components.strong,{children:`não`}),` são repassadas à Datacrazy: o formato dela não\ntem como marcar que a mensagem é só uma cópia, e a automação de lá\nresponderia uma conversa que não é da D-API.`]})}),_jsx(Accordion,{title:`Quanto tempo uma conversa fica com o mesmo dono?`,id:`quanto-tempo-uma-conversa-fica-com-o-mesmo-dono`,children:_jsxs(_components.p,{children:[`Até ser entregue, solta ou assumida, ou até `,_jsx(_components.strong,{children:`24h sem mensagem do\ncliente`}),`. Depois disso ela fica livre, e a próxima mensagem do cliente\nescolhe o dono de novo pela entrada.`]})}),_jsx(Accordion,{title:`Ao conectar a D-API num número que já usa outro parceiro, algo muda para ele?`,id:`ao-conectar-a-d-api-num-numero-que-ja-usa-outro-parceiro-algo-muda-para-ele`,children:_jsxs(_components.p,{children:[`A D-API não registra de novo um número que já está ativo na API Oficial\ncom outro parceiro, para não trocar a verificação em duas etapas que ele\nconfigurou. Mas a `,_jsx(_components.strong,{children:`Meta`}),` pode criar uma configuração de roteamento\nautomática quando o segundo parceiro entra. Depois de conectar, confira a\nconfiguração no Meta Business Suite.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Vários parceiros no mesmo número","description":"Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.","href":"/api-oficial/multiplos-parceiros"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Por que isso existe","slug":"por-que-isso-existe","depth":2,"children":[]},{"title":"Conceitos","slug":"conceitos","depth":2,"children":[{"title":"O que cada parceiro pode fazer","slug":"o-que-cada-parceiro-pode-fazer","depth":3,"children":[]}]},{"title":"1. Descubra a situação do número","slug":"1-descubra-a-situação-do-número","depth":2,"children":[]},{"title":"2. Configure o roteamento no Meta Business Suite","slug":"2-configure-o-roteamento-no-meta-business-suite","depth":2,"children":[]},{"title":"3. Casos de uso","slug":"3-casos-de-uso","depth":2,"children":[]},{"title":"4. Trocar o dono de uma conversa","slug":"4-trocar-o-dono-de-uma-conversa","depth":2,"children":[{"title":"Assumir (take)","slug":"assumir-take","depth":3,"children":[]},{"title":"Entregar (pass)","slug":"entregar-pass","depth":3,"children":[]},{"title":"Soltar (release)","slug":"soltar-release","depth":3,"children":[]},{"title":"Erros","slug":"erros","depth":3,"children":[]}]},{"title":"5. Webhooks","slug":"5-webhooks","depth":2,"children":[{"title":"Cópias de conversas de outros parceiros: is_standby","slug":"cópias-de-conversas-de-outros-parceiros-is_standby","depth":3,"children":[],"tabId":"modo-normalized"},{"title":"Troca de dono: conversation.control_changed","slug":"troca-de-dono-conversation-control_changed","depth":3,"children":[],"tabId":"modo-normalized"}]},{"title":"6. Envio numa conversa de outro parceiro: erro 131070","slug":"6-envio-numa-conversa-de-outro-parceiro-erro-131070","depth":2,"children":[]},{"title":"Perguntas frequentes","slug":"perguntas-frequentes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"d-api","siteName":"D-API","title":"Vários parceiros no mesmo número - D-API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/api-oficial/multiplos-parceiros","matchLevel":0},"en":{"href":"/en/api-oficial/multiplos-parceiros","matchLevel":1}}},"lastModified":"2026-11-12T12:25:48.669Z","originalFileLocation":"api-oficial/multiplos-parceiros.mdx","locale":"pt-BR"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.\">\u003cmeta data-mint-head name=\"application-name\" content=\"D-API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Vários parceiros no mesmo número - D-API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"D-API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://d-api.mintlify.site/_mintlify/api/og/v2?division=V%C3%A1rios+parceiros\u0026amp;title=V%C3%A1rios+parceiros+no+mesmo+n%C3%BAmero\u0026amp;description=Como+usar+a+D-API+junto+com+outra+plataforma+no+mesmo+n%C3%BAmero+da+API+Oficial%3A+quem+responde+cada+conversa%2C+modo+standby%2C+fallback+e+como+trocar+o+dono+de+uma+con\u0026amp;theme=6bf39124e553ea1529d3e32e\u0026amp;signature=d1ebba847dc3147e5ea9dc92f9369c2b61ad8b93adc5daafd105e73d49c0f953\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Vários parceiros no mesmo número - D-API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://d-api.mintlify.site/_mintlify/api/og/v2?division=V%C3%A1rios+parceiros\u0026amp;title=V%C3%A1rios+parceiros+no+mesmo+n%C3%BAmero\u0026amp;description=Como+usar+a+D-API+junto+com+outra+plataforma+no+mesmo+n%C3%BAmero+da+API+Oficial%3A+quem+responde+cada+conversa%2C+modo+standby%2C+fallback+e+como+trocar+o+dono+de+uma+con\u0026amp;theme=6bf39124e553ea1529d3e32e\u0026amp;signature=d1ebba847dc3147e5ea9dc92f9369c2b61ad8b93adc5daafd105e73d49c0f953\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/d-api/36SbMupri6RA-H0W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"D-API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00B7CD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-oficial/multiplos-parceiros.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.d-api.cloud/en/api-oficial/multiplos-parceiros\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.d-api.cloud/#organization\",\"name\":\"D-API\",\"url\":\"https://docs.d-api.cloud\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/d-api/dcX-Hd4-QsKLE866/logo/dapi-horizontal.png?fit=max\u0026auto=format\u0026n=dcX-Hd4-QsKLE866\u0026q=85\u0026s=449901bb5b53e11232d03fd1fa54a4c3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.d-api.cloud#website\",\"name\":\"D-API\",\"url\":\"https://docs.d-api.cloud\",\"publisher\":{\"@id\":\"https://docs.d-api.cloud/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros#webpage\",\"url\":\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros\",\"name\":\"Vários parceiros no mesmo número\",\"description\":\"Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.\",\"dateModified\":\"2026-11-12T12:25:48.669Z\",\"isPartOf\":{\"@id\":\"https://docs.d-api.cloud#website\"},\"breadcrumb\":{\"@id\":\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"D-API\",\"item\":\"https://docs.d-api.cloud\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Vários parceiros no mesmo número\",\"item\":\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros#article\",\"headline\":\"Vários parceiros no mesmo número\",\"name\":\"Vários parceiros no mesmo número\",\"description\":\"Como usar a D-API junto com outra plataforma no mesmo número da API Oficial: quem responde cada conversa, modo standby, fallback e como trocar o dono de uma conversa.\",\"url\":\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros\",\"mainEntityOfPage\":{\"@id\":\"https://docs.d-api.cloud/api-oficial/multiplos-parceiros#webpage\"},\"dateModified\":\"2026-11-12T12:25:48.669Z\",\"publisher\":{\"@id\":\"https://docs.d-api.cloud/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.d-api.cloud#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"D-API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"D-API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-oficial/multiplos-parceiros.md","siteName":"D-API","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"tabs":[{"tab":"WhatsApp","pages":[{"title":"WhatsApp","href":"/whatsapp/introducao"}]},{"tab":"API Oficial","groups":[{"group":"SaaS (provedor)","pages":[{"title":"API Oficial para SaaS (provedor)","description":"Ofereça a conexão do WhatsApp API Oficial dentro do seu próprio SaaS, usando a D-API como provedor.","href":"/api-oficial/saas"}]},{"group":"Vários parceiros","pages":[{"title":"Vários parceiros no mesmo número","href":"/api-oficial/multiplos-parceiros"}]}]},{"tab":"SMS","pages":[{"title":"SMS","href":"/sms/webhooks/visao-geral"}]},{"tab":"URA","pages":[{"title":"URA","href":"/ura/ligacoes/stream"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},{"language":"en","footer":{"links":[{"header":"D-API","items":[{"label":"Dashboard","href":"https://app.d-api.cloud"},{"label":"Support","href":"https://wa.me/5551920018823?text=Hi%2C%20I%20need%20help%20with%20the%20D-API%20documentation"}]}]},"navbar":{"links":[{"href":"https://wa.me/5551920018823?text=Hi%2C%20I%20need%20help%20with%20the%20D-API%20documentation","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.d-api.cloud"}},"pages":[{"title":"en","href":"/en/api-oficial/multiplos-parceiros"}]}]},"basePath":"","title":"Vários parceiros no mesmo número - D-API","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}